snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 2s

This commit is contained in:
upstream-mirror
2026-09-17 23:28:13 +05:00
commit e7da97194a
32688 changed files with 4208681 additions and 0 deletions

View File

@@ -0,0 +1,30 @@
---
title: وكلاء الذكاء الاصطناعي
description: ادمج قدرات الذكاء الاصطناعي مباشرةً في سير العمل المؤتمت لديك.
---
## نظرة عامة
ادمج قدرات الذكاء الاصطناعي مباشرةً في سير العمل المؤتمت لديك لمعالجة البيانات بذكاء واتخاذ القرارات.
## القدرات
| الميزة | الوصف |
| ---------------------------- | -------------------------------------------------- |
| **إجراءات الذكاء الاصطناعي** | أضِف خطوات مدعومة بالذكاء الاصطناعي إلى أي سير عمل |
| **إثراء البيانات** | تحسين السجلات تلقائيًا ببيانات خارجية |
| **التصنيف** | تصنيف السجلات استنادًا إلى تحليل المحتوى |
| **التلخيص** | إنشاء ملخصات من حقول النص |
| **مطالبات مخصصة** | حدِّد بدقة كيف يعالج الذكاء الاصطناعي بياناتك |
## حالات الاستخدام
* **تقييم العملاء المحتملين**: تقييم العملاء المحتملين الواردين تلقائيًا وتحديد أولوياتهم
* **تنظيف البيانات**: توحيد أسماء الشركات ومعلومات الاتصال
* **مسودات البريد الإلكتروني**: إنشاء رسائل متابعة عبر البريد الإلكتروني استنادًا إلى ملاحظات الاجتماعات
* **توجيه السجلات**: إسناد السجلات إلى عضو الفريق المناسب بناءً على المحتوى
## ذات صلة
* [نظرة عامة على سير العمل](/l/ar/user-guide/workflows/overview) — أساسيات الأتمتة
* [أذونات الذكاء الاصطناعي](/l/ar/user-guide/ai/capabilities/permissions-access-control) — التحكم في الوصول لوكلاء الذكاء الاصطناعي

View File

@@ -0,0 +1,37 @@
---
title: روبوت محادثة بالذكاء الاصطناعي
description: مساعد ذكي يساعدك على التفاعل مع بيانات إدارة علاقات العملاء باستخدام اللغة الطبيعية.
---
## نظرة عامة
طرح أسئلة في اللغة الطبيعية والمساعد يسترجع ويفسر بيانات إدارة علاقات العملاء الخاصة بك لك.
## القدرات
| الميزة | الوصف |
| ----------------------------- | ----------------------------------------------------------------- |
| **استعلامات باللغة الطبيعية** | اطرح أسئلة باللغة الإنجليزية البسيطة بدلاً من إنشاء عوامل تصفية |
| **وصول كامل إلى البيانات** | استعلم عن السجلات والعلاقات والمقاييس عبر مساحة عملك |
| **سياق الصفحة** | الإشارة إلى "هذه الشركة" أو "هذه الفرصة" استناداً إلى عرضك الحالي |
| **حواري** | تحافظ الأسئلة اللاحقة على السياق من الاستعلامات السابقة |
## أمثلة على التفاعلات
### العثور على السجلات
* "اعرض لي كل الفرص التي تزيد عن $50,000"
* "ابحث عن جهات الاتصال التي لم أرسل لها بريد إلكتروني منذ أسبوعين"
* "اسرد الشركات في قطاع الرعاية الصحية"
### الحصول على رؤى
* "ما القيمة الإجمالية لمسار المبيعات لدي?"
* "كم عدد الصفقات التي أبرمت الشهر الماضي?"
* "أي مرحلة تضم أكبر عدد من الفرص العالقة?"
### استخدام سياق الصفحة
* "لخص تفاعلاتي مع هذا الشخص" (على صفحة جهة اتصال)
* "ما الفرص المرتبطة بهذه الشركة?" (على صفحة شركة)
* "متى جرى آخر تحديث لهذه الصفقة?" (على صفحة فرصة)

View File

@@ -0,0 +1,137 @@
---
title: خادم MCP
description: اربط مساعدي الذكاء الاصطناعي بمساحة عمل Twenty الخاصة بك باستخدام بروتوكول سياق النموذج.
---
تعرض Twenty خادم [MCP](https://modelcontextprotocol.io/) بحيث تتمكّن مساعدات الذكاء الاصطناعي — Claude Desktop وClaude Code وCursor وChatGPT وغيرها — من قراءة وكتابة بيانات نظام إدارة علاقات العملاء (CRM) لديك باستخدام اللغة الطبيعية.
استخدم **عنوان URL لمساحة العمل** (عنوان URL الذي تستخدمه للوصول إلى Twenty) كنقطة نهاية MCP. على Twenty Cloud، قد يكون عنوان URL لمساحة العمل هو `https://{mycompany}.twenty.com` أو نطاق مخصص. الخادم متاح على:
| البيئة | نقطة نهاية MCP |
| --------------------- | ---------------------------------------------------------------------------------------- |
| **السحابة** | `https://{your-workspace-url}/mcp` (على سبيل المثال: `https://mycompany.twenty.com/mcp`) |
| **الاستضافة الذاتية** | `https://{your-domain}/mcp` |
## طرق المصادقة
لديك طريقتان لمصادقة عميل MCP: **OAuth** (مُوصى بها) أو **مفتاح API**.
### الخيار أ — OAuth (مُوصى به)
باستخدام OAuth، يفتح عميل MCP لديك نافذة متصفح لتسجيل الدخول. لا يتم تخزين أي أسرار في ملفات الإعداد، ويتم تحديث الرموز المميِّزة تلقائيًا.
<Note>
يتطلب OAuth عميل MCP يدعم [مواصفة تفويض MCP](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization). تدعمه Claude Desktop وClaude Code وCursor وChatGPT.
</Note>
أضِف ما يلي إلى تهيئة عميل MCP لديك، واستبدِل `{your-workspace-url}` بمضيف مساحة العمل لديك (على سبيل المثال: `mycompany.twenty.com`):
```json
{
"mcpServers": {
"twenty": {
"type": "streamable-http",
"url": "https://{your-workspace-url}/mcp"
}
}
}
```
هذا كل شيء — لا حاجة إلى مفتاح API. عند اتصال العميل للمرة الأولى، سيفعل ما يلي:
1. اكتشاف بيانات التعريف الخاصة بـ OAuth لدى Twenty عبر `/.well-known/oauth-protected-resource` و`/.well-known/oauth-authorization-server`
2. تسجيل نفسه كعميل OAuth عبر التسجيل الديناميكي للعميل (RFC 7591)
3. فتح متصفحك لتفويض الوصول
4. استلام الرموز المميِّزة والاتصال بخادم MCP
تعيد الاتصالات اللاحقة استخدام الرموز المميِّزة المخزنة وتحدِّثها تلقائيًا.
### الخيار ب — مفتاح API
إذا كان عميل MCP لديك لا يدعم OAuth، أو كنت تفضّل بيانات اعتماد ثابتة، فمرِّر مفتاح API في ترويسة `Authorization`:
```json
{
"mcpServers": {
"twenty": {
"type": "streamable-http",
"url": "https://{your-workspace-url}/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
```
<Warning>
يمنح مفتاح API الخاص بك حق الوصول إلى بيانات مساحة العمل. أبعِده عن أنظمة التحكم في الإصدارات وملفات dotfiles المشتركة.
</Warning>
لإنشاء مفتاح API، انتقل إلى **Settings → MCP & APIs → API → + Create key**. راجع [واجهات برمجة التطبيقات](/l/ar/developers/extend/api#create-an-api-key) للتفاصيل.
## البدء السريع
### 1. انسخ الإعداد
انتقل إلى **Settings → MCP & APIs → MCP** في Twenty. اختر طريقة المصادقة (OAuth أو مفتاح API)، وانسخ مقطع JSON (سيستخدم بالفعل عنوان URL لمساحة العمل لديك)، ثم الصقه في ملف إعدادات عميل MCP لديك.
| العميل | موقع ملف الإعداد |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Claude Desktop** | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) أو `%APPDATA%\Claude\claude_desktop_config.json` (Windows) |
| **Claude Code** | `~/.claude.json` (المستخدم) أو `.mcp.json` (المشروع) |
| **Cursor** | `.cursor/mcp.json` ضمن مشروعك، أو `~/.cursor/mcp.json` عالميًا |
| **ChatGPT** | فعِّل وضع المطوّر في **Settings → Apps & Connectors → Advanced settings**، ثم استخدم **Create** في **Settings → Apps & Connectors** لإضافة خادم MCP |
### 2. الاتصال
أعِد تشغيل عميل MCP لديك (أو أعد تحميل ملف الإعداد). إذا كنت تستخدم OAuth فسيتم توجيهك إلى Twenty لتفويض الوصول. إذا كنت تستخدم مفتاح API فسيكون الاتصال فوريًا.
### 3. ابدأ باستخدامه
اطلب من مساعد الذكاء الاصطناعي التفاعل مع نظام إدارة علاقات العملاء (CRM) لديك:
* *"أرني أحدث 5 شركات تم إنشاؤها"*
* *"أنشئ شخصًا جديدًا باسم Jane Doe في Acme Corp"*
* *"اعثر على جميع الفرص المفتوحة التي تزيد قيمتها عن 10 آلاف دولار"*
## الأدوات المتاحة
بعد الاتصال، يوفّر خادم MCP أدوات تعكس واجهة برمجة تطبيقات Twenty (API). سير العمل الموصى به هو:
1. **`learn_tools`** — احصل على مخطط الإدخال لأدوات محددة
2. **`execute_tool`** — شغّل أداة
لا تحتاج إلى تذكّر أسماء الأدوات. اسأل مساعد الذكاء الاصطناعي عمّا يمكنه فعله وسيستدعي `learn_tools` تلقائيًا.
## الصلاحيات
ترث اتصالات MCP أذونات المستخدم المُصادَق عليه (OAuth) أو الدور المُعيَّن لمفتاح API. لتقييد ما يمكن لخادم MCP القيام به:
* **OAuth**: ينطبق دور المستخدم في مساحة العمل.
* **API Key**: عيِّن دورًا لمفتاح API ضمن **Settings → Members → Roles**. راجع [الأذونات](/l/ar/user-guide/permissions-access/capabilities/permissions).
## التكوين ذاتي الاستضافة
في حالات الاستضافة الذاتية، استبدِل `{your-workspace-url}` بعنوان URL الخاص بالخادم لديك. تأكّد من أن قيمة `SERVER_URL` في بيئتك تطابق عنوان URL العام لمثيل Twenty لديك — إذ يُستخدَم ذلك لإنشاء بيانات تعريف اكتشاف OAuth.
```bash
SERVER_URL=https://twenty.yourcompany.com
```
تُشتق نقطة نهاية MCP ونقاط نهاية OAuth وبيانات تعريف الاكتشاف جميعها من هذه القيمة.
## استكشاف الأخطاء وإصلاحها
**أخطاء "Unauthorized" أو 401**
* OAuth: أعد التفويض عبر مسح الرموز المميِّزة المخزنة في عميل MCP لديك ثم أعد الاتصال.
* API Key: تحقّق من أن المفتاح صالح ولم تنتهِ صلاحيته. أعِد توليده إذا لزم الأمر.
**عملية OAuth لا تفتح متصفحًا**
* تأكّد من أن عميل MCP لديك يدعم تفويض MCP. ارجع إلى طريقة مفتاح API إذا لم يكن كذلك.
**انتهاء مهلة الاتصال**
* تحقّق من إمكانية الوصول إلى عنوان URL لنقطة نهاية MCP من جهازك. بالنسبة لحالات الاستضافة الذاتية، تحقّق من أن الخادم يعمل وأن `SERVER_URL` مُعيَّن بشكل صحيح.

View File

@@ -0,0 +1,35 @@
---
title: الأذونات والتحكم في الوصول
description: تحكّم بما يمكن لوكلاء الذكاء الاصطناعي الوصول إليه وتعديله في مساحة عملك.
---
## نظرة عامة
يحترم وكلاء الذكاء الاصطناعي هيكل الأذونات الحالي لديك. وهذا مهم بشكل خاص للفرق التي تريد التحكّم بدقة في ما يمكن لعمليات الذكاء الاصطناعي المؤتمتة الوصول إليه أو تعديله في مساحة عملها.
## تعيين دور لوكيل ذكاء اصطناعي
1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. انقر على الدور الذي ترغب في تعيينه
3. افتح علامة التبويب **التعيين**
4. ضمن **وكلاء الذكاء الاصطناعي**، انقر **+ تعيين لوكيل ذكاء اصطناعي**
5. اختر وكيل الذكاء الاصطناعي من القائمة
6. أكد التعيين
## لماذا نعيّن أدوارًا لوكلاء الذكاء الاصطناعي؟
| الفائدة | الوصف |
| ------------------- | --------------------------------------------------------------------- |
| **الأمان** | قيِّد ما يمكن لوكلاء الذكاء الاصطناعي الوصول إليه أو تعديله من بيانات |
| **الامتثال** | ضمان أن يعالج الذكاء الاصطناعي فقط البيانات التي يحتاجها |
| **التحكم** | منع الإجراءات غير المقصودة الناتجة عن أتمتة الذكاء الاصطناعي |
| **إمكانية التدقيق** | تتبُّع الإجراءات التي نفّذها كل وكيل |
<Note>
بالنسبة لوكلاء الذكاء الاصطناعي الذين يعملون ضمن سير العمل، يضمن تعيين الدور ألا يتمكّن الوكيل من الوصول إلى البيانات أو تعديلها خارج نطاقه المقصود — حتى إذا كانت لسير العمل أذونات أوسع.
</Note>
## ذات صلة
* [الأذونات](/l/ar/user-guide/permissions-access/capabilities/permissions) — معلومات مفصلة حول إنشاء الأدوار وإدارتها
* [وكلاء الذكاء الاصطناعي](/l/ar/user-guide/ai/capabilities/ai-agents) — قدرات الذكاء الاصطناعي ضمن سير العمل

View File

@@ -0,0 +1,31 @@
---
title: الأسئلة الشائعة حول الذكاء الاصطناعي
description: الأسئلة الشائعة حول ميزات الذكاء الاصطناعي في Twenty.
---
<AccordionGroup>
<Accordion title="ما هي قدرات الذكاء الاصطناعي المتاحة؟">
القدرتان الرئيسيتان للذكاء الاصطناعي هما:
1. **روبوت دردشة بالذكاء الاصطناعي**: مساعد مدرك للسياق يمكنه الوصول إلى بياناتك في Twenty ومساعدتك في الاستفسارات
2. **وكلاء الذكاء الاصطناعي في سير العمل**: أتمتة ذكية يمكنها معالجة البيانات واتخاذ القرارات وتنفيذ المهام ضمن سير عملك
</Accordion>
<Accordion title="هل لوكلاء الذكاء الاصطناعي حق الوصول إلى جميع بياناتي؟">
ويعمل وكلاء الذكاء الاصطناعي بموجب نظام التصريح. يمكنك تعيين أدوار محددة لوكلاء الذكاء الاصطناعي ضمن **الإعدادات → الأعضاء → الأدوار**، مما يمنحك سيطرة كاملة على البيانات التي يمكنهم الوصول إليها والإجراءات التي يمكنهم القيام بها.
</Accordion>
<Accordion title="كيف تعمل أرصدة الذكاء الاصطناعي؟">
تستهلك إجراءات الذكاء الاصطناعي أرصدة سير العمل بناءً على تعقيد المهمة ونموذج الذكاء الاصطناعي المستخدم.
</Accordion>
<Accordion title="هل يمكنني استخدام نماذج الذكاء الاصطناعي الخاصة بي؟">
في السحابة، يمكنك استخدام نماذج الذكاء الاصطناعي التي توفرها Twenty فقط. في مثيلك المُستضاف ذاتيًا، يمكنك استخدام نماذج الذكاء الاصطناعي الخاصة بك بعد الحصول على ترخيص المؤسسة.
</Accordion>
<Accordion title="لا أرى الدور الذي أسنده لوكيل الذكاء الاصطناعي، أين هي؟">
افتراضيًا، تتم تصفية قائمة الأدوار لتشمل الأدوار القابلة للإسناد لأعضاء مساحة العمل. إذا كان الدور يمكن تعيينه فقط لوكلاء الذكاء الاصطناعي، تحتاج إلى تغيير الفلتر ليشمل أدوار وكيل AI.
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,58 @@
---
title: الذكاء الاصطناعي
description: ميزات مدعومة بالذكاء الاصطناعي في Twenty.
---
<Frame>
<img src="/images/user-guide/workflows/robot.png" alt="الذكاء الاصطناعي" />
</Frame>
## الميزات
حاليًا، يوفّر Twenty ما يلي:
### 1. روبوت محادثة بالذكاء الاصطناعي
مساعد محادثة يفهم سياقك ولديه إمكانية الوصول إلى جميع بياناتك في Twenty.
**القدرات الرئيسية:**
* **وصول كامل إلى البيانات**: الاستعلام عن أي سجل أو علاقة أو مقياس في مساحة العمل لديك
* **إدراك سياق الصفحة**: الإشارة إلى "هذه الشركة" أو "هذه الفرصة" بناءً على مكانك في Twenty
* **اللغة الطبيعية**: اطرح الأسئلة واحصل على الإجابات دون التنقل عبر القوائم
**أمثلة على الموجهات:**
* "ما الفرص التي ستُغلق هذا الشهر؟"
* "ما الصفقات التي كانت في مرحلة التفاوض لمدة تزيد على 30 يومًا؟"
* "لخِّص تفاعلاتي مع هذا الشخص"
### ٢. وكلاء الذكاء الاصطناعي في سير العمل
وسِّع سير العمل لديك بإجراءات مدعومة بالذكاء الاصطناعي ووكلاء مستقلين.
**القدرات الرئيسية:**
* **إجراءات الذكاء الاصطناعي**: استخدم الذكاء الاصطناعي لإثراء البيانات، وتصنيف السجلات، وإنشاء الملخصات، والمزيد
* **وكلاء مستقلون**: اسمح للوكلاء بتنفيذ مهام متعددة الخطوات ضمن سير عمل
* **موجهات مخصّصة**: حدِّد بدقة كيف ينبغي للذكاء الاصطناعي معالجة بياناتك
**حالات الاستخدام:**
* تصنيف العملاء المحتملين الواردين تلقائيًا
* إثراء بيانات الشركة من المصادر العامة
* إنشاء مسودات رسائل متابعة عبر البريد الإلكتروني استنادًا إلى ملاحظات الاجتماعات
* تقييم الفرص استنادًا إلى أنماط التفاعل
## الأذونات والتحكّم في الوصول
يُدار وكلاء الذكاء الاصطناعي عبر نظام الأذونات الحالي:
1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. حدِّد البيانات التي يمكن لكل وكيل ذكاء اصطناعي الوصول إليها
3. عيّن أذونات القراءة/الكتابة لكل كائن
يضمن ذلك التزام وكلاء الذكاء الاصطناعي بسياسات حوكمة البيانات لديك والوصول فقط إلى ما يحتاجون إليه.
* تابع [GitHub](https://github.com/twentyhq/twenty) للاطّلاع على تحديثات التطوير
* انضم إلى [Discord](https://discord.gg/UfGNZJfAG6) لمشاركة الملاحظات وطلبات الميزات

View File

@@ -0,0 +1,74 @@
---
title: الشكر والتقدير
description: رصيد بسيط واحد يشغّل سير العمل لديك، ووكلاء الذكاء الاصطناعي، ودردشة الذكاء الاصطناعي — ما قيمة الرصيد، إلى أي مدى يمتد، وكيفية إدارته.
---
## ما هي الأرصدة؟
الأرصدة عبارة عن رصيد واحد يشغّل كل ما نقوم بتشغيله نيابةً عنك وله تكلفة فعلية: **أتمتة سير العمل**، و**وكلاء الذكاء الاصطناعي**، و**دردشة الذكاء الاصطناعي**. بدلًا من التعامل مع حصص منفصلة لـ "مرات تشغيل الأتمتة" و"رموز الذكاء الاصطناعي"، سيكون لديك رصيد واحد وبسيط لمتابعته.
**1 رصيد = 1 دولار من الاستخدام.** الرصيد هو مجرد دولار من العمل، لذا سيكون من السهل فهم رصيدك — دون أي وحدات مجرّدة تحتاج إلى تحويل.
## ما مدى كفاية الرصيد الواحد؟
التكلفة تتناسب مع حجم العمل. أتمتة المهام اليومية والرسائل السريعة للذكاء الاصطناعي تكلف جزءًا صغيرًا جدًا من الرصيد؛ بينما تكلف مهام وكلاء الذكاء الاصطناعي الكبيرة ومتعددة الخطوات أكثر. إليك صورة تقريبية:
| ماذا تفعل | التكلفة التقريبية | ماذا يعني ذلك |
| ------------------------------------------------------------------------------------------ | --------------------------------------- | ------------------------------- |
| تشغيل خطوة قياسية لسير العمل (البحث أو إنشاء أو تحديث السجلات) أو تشغيل وظيفة منطق التطبيق | $0.0001 | **10,000 عملية تشغيل لكل رصيد** |
| استدعاء واجهة برمجة تطبيقات خارجية أو تشغيل عقدة كود | جزء صغير من رصيد واحد | آلاف لكل رصيد |
| إرسال رسالة محادثة سريعة بالذكاء الاصطناعي أو خطوة ذكاء اصطناعي بسيطة | جزء من سنت | مئات لكل رصيد |
| تشغيل مهمة كبيرة لوكيل ذكاء اصطناعي (مثل "تهيئة 10 كائنات مساحة عمل") | قد تصل تكلفتها إلى **حوالي $1 أو أكثر** | عدد قليل لكل رصيد |
| تشغيل بحث ويب بالذكاء الاصطناعي | تكلفة ثابتة لكل عملية بحث | مئات عمليات البحث لكل رصيد |
<Note>
بالنسبة لمعظم الفرق، تكون الأتمتة القياسية مجانية فعليًا — فلن تلاحظ انخفاضًا ملموسًا في رصيدك إلا عندما تعتمد على ميزات الذكاء الاصطناعي أو تشغّل عقد كود ثقيلة. وهذا مقصود: صُمِّمت الأرصدة المضمّنة لتمكّنك من البناء دون الحاجة إلى مراقبة عدّاد.
</Note>
<Note>
لا تُحصِّل كل التطبيقات رسومًا مقابل عمليات التشغيل الخاصة بها. مسجل المكالمات و آخر جهة اتصال تتفاعل مع كل حدث بريد إلكتروني و تقويم مستورد إلى مساحة العمل الخاصة بك، لذلك تعمل وظيفتهم المنطقية مجانا. ما زلت تُحاسَب على الاستخدام المُقاس الذي يقومان به، مثل دقائق المكالمات المسجَّلة.
</Note>
## كيفية احتساب استخدام الذكاء الاصطناعي
عندما تستدعي أي إجراء نموذج ذكاء اصطناعي، نقيس عدد الرموز المستخدمة بدقة ونحتسبها وفق **الأسعار المنشورة من مزود النموذج**، ثم نحول مبلغ الدولار الناتج مباشرة إلى أرصدة — بحيث يعكس إنفاقك التكلفة الحقيقية للعمل، وليس سعرًا داخليًا معادًا تسعيره. رسالة محادثة قصيرة تكلف جزءًا من سنت. إن مهمة الوكيل الكبيرة - ولنقل تشكيل 10 أجسام في فضاء العمل - تستدعي الكثير من النماذج في سياق متزايد، حتى يمكنها أن تضيف ما يصل إلى دولار أو أكثر. يتم احتساب الرسوم بناءً على ما تستخدمه فعليًا، حتى على مستوى الرمز الواحد.
تختلف التكلفة حسب النموذج: فالنموذج خفيف الوزن أرخص بكثير لكل رسالة من نموذج الاستدلال المتقدم من أعلى الفئة. يمكنك رؤية تفاصيل التكلفة لكل إجراء — بما في ذلك أي نموذج تم استخدامه — في **الإعدادات → الفوترة**.
## ما الذي يتضمّنه
يتضمّن كل اشتراك أرصدة، وتختلف الكمية حسب **دورة الفوترة** الخاصة بك، وليس حسب خطتك:
| دورة الفوترة | الأرصدة المضمّنة | الاستخدام المتساوي |
| ------------ | ---------------- | ------------------------- |
| شهري | 5 / شهر | استخدام بقيمة ~$5 كل شهر |
| سنوي | 50 / سنة | استخدام بقيمة ~$50 كل سنة |
هذه الأرصدة مصممة لتغطية الأتمتة اليومية براحة. خمسة أرصدة تغطي عشرات الآلاف من خطوات التشغيل الآلي العادية أو مئات من الرسائل السريعة الذكاء الاصطناعي - وإن كانت حفنة كبيرة منها، يمكن لمهام وكيل متعدد الخطوات أن تستعملها بشكل أسرع. يمكنك إضافة رصيد في أي وقت (انظر أدناه).
## ترحيل الأرصدة
يتم ترحيل الأرصدة غير المستخدمة تلقائيًا إلى فترة الفوترة التالية.
* **الحد الأقصى**: الحد الأقصى للتخصيص الكامل لدورة، لذلك لن ترحل أكثر مما توفره دورة الفوترة الخاصة بك في كل فترة.
* **الظهور**: عند توفّر أرصدة مُرحّلة، تظهر كبند منفصل بعنوان **الأرصدة المُرحّلة** في **الإعدادات → الفوترة**، إلى جانب رصيد **الإجمالي المتاح**.
## رصد الاستخدام
تابع رصيدك وأين يتم استهلاكه:
1. اذهب إلى **الإعدادات → الفوترة**
2. اطّلع على **الأرصدة المتبقية** و**الاستخدام خلال الفترة الحالية**
3. تعمّق في التفاصيل لترى أي سير عمل وإجراءات ذكاء اصطناعي تستهلك الأرصدة — وأي النماذج استخدمتها إجراءات الذكاء الاصطناعي
مراجعة هذا بانتظام تسهّل عليك اكتشاف سير عمل كثيف مبكرًا واتخاذ قرار بشأن تحسينه أو إضافة رصيد.
## هل تحتاج إلى المزيد من الأرصدة؟
إذا نفد رصيدك — أو أردت هامش أمان قبل دفعة أتمتة كبيرة — يمكنك شراء حزم أرصدة إضافية في أي وقت:
1. اذهب إلى **الإعدادات → الفوترة**
2. انقر فوق زر **زيادة**
3. حدد المبلغ الذي تحتاجه وقبول التغييرات
تُضاف الأرصدة المشتراة إلى رصيدك المتاح فورًا.

View File

@@ -0,0 +1,100 @@
---
title: خطط التسعير
description: تعرّف على خطط تسعير Twenty وكيفية التبديل بينها.
---
## نظرة عامة
توفر Twenty تسعيرًا مرنًا ليناسب الفرق بمختلف أحجامها، سواء كنت تفضّل الاستضافة السحابية أو الاستضافة الذاتية.
## الخطط السحابية
### Pro (سحابي)
للفرق الجاهزة للتوسّع:
* جميع ميزات إدارة علاقات العملاء (CRM) الأساسية
* مزامنة البريد الإلكتروني والتقويم
* عمليات سير العمل والأتمتة
* دعم قياسي
<Note>
الميزات المتميزة (SSO، أذونات على مستوى الصف، بيانات استخدام الذكاء الاصطناعي والمزيد) غير مشمولة في خطة Pro.
</Note>
### المؤسسة (سحابي)
للفرق الأكبر ذات الاحتياجات المتقدّمة:
* كل ما في Pro
* **الميزات المتميزة**: تكامل SSO، أذونات على مستوى الصف، بيانات استخدام الذكاء الاصطناعي والمزيد
* دعم متميز
## خطط الاستضافة الذاتية
### مجاني (استضافة ذاتية)
استضف Twenty على بُنيتك التحتية الخاصة دون أي تكلفة:
* تشمل جميع ميزات Pro
* دعم المجتمع عبر Discord
* تحكّم كامل في بياناتك
### المؤسسة (استضافة ذاتية)
للفرق التي تحتاج إلى ميزات متميزة أثناء الاستضافة الذاتية:
* جميع ميزات Pro
* **الميزات المتميزة**: تكامل SSO، أذونات على مستوى الصف، بيانات استخدام الذكاء الاصطناعي والمزيد
* دعم فريق Twenty
* لا يُشترط نشر الشيفرة المخصّصة كمفتوح المصدر قبل التوزيع
## الميزات المتميزة
الميزات المتميزة متاحة فقط في خطط المؤسسة (السحابي أو الاستضافة الذاتية):
* **تكامل SSO**: تسجيل دخول أحادي مع موفّر الهوية لديك
* **أذونات على مستوى الصف**: تحكّم دقيق في الوصول على مستوى السجل
* **بيانات استخدام الذكاء الاصطناعي**: تتبع استهلاك الذكاء الاصطناعي عبر مساحة العمل
* **سجلات التدقيق**: تحقق مما كان يفعله كل عضو في مساحة العمل
* **حملات البريد الإلكتروني**: خطط لرسائل البريد الإلكتروني التي يجب إرسالها (ستتوفر قريبًا)
* **مساحات عمل غير محدودة**: أنشئ عددًا غير محدود من مساحات العمل كما تريد (الاستضافة الذاتية فقط)
* **شفرة مصدر خاصة**: لا حاجة لنشر التغييرات في مستودع متاح للعامة (الاستضافة الذاتية فقط)
## التبديل بين الخطط
### الترقية إلى المؤسسة
1. اذهب إلى **الإعدادات → الفواتير → الخطط**
2. انقر **التبديل إلى المؤسسة**
3. أكِّد الترقية
### الرجوع إلى Pro
1. اذهب إلى **الإعدادات → الفواتير → الخطط**
2. انقر على **التبديل إلى الخطة المحترفة**
3. أكد خفض خطتك
### التبديل إلى الفوترة السنوية
1. اذهب إلى **الإعدادات → الفواتير**
2. انقر على **الترقية إلى الخطة السنوية**
3. وفّر مع الفوترة السنوية
### التبديل إلى الفوترة الشهرية
1. اذهب إلى **الإعدادات → الفواتير**
2. انقر على **التحويل إلى دفع شهري**
3. وفّر مع الفوترة الشهرية
## احصل على مفتاح Enterprise لخطة Organization (Self-Hosted)
لاستخدام خطة Organization (Self-Hosted)، تحتاج إلى الحصول على مفتاح Enterprise:
1. اذهب إلى **الإعدادات → لوحة الإدارة → Enterprise**
<img src="/images/user-guide/billing/enterprise-key.png" alt="مفتاح Enterprise" />
2. انقر **احصل على مفتاح Enterprise**
3. عند إعادة توجيهك إلى Stripe، أدخل تفاصيل الدفع الخاصة بك وأكّد
4. عند عرض مفتاح Enterprise الخاص بك، الصقه في صفحة إعدادات Enterprise وقم بتفعيل ترخيص Organization

View File

@@ -0,0 +1,105 @@
---
title: الأسئلة الشائعة حول الفوترة
description: الأسئلة الشائعة حول تسعير Twenty والفوترة.
---
## التسعير
<AccordionGroup>
<Accordion title="هل يمكنني استخدام Twenty مجانًا أثناء الاستضافة الذاتية؟">
نعم، يمكنك استخدام Twenty مجانًا أثناء الاستضافة الذاتية. ستحصل على حق الوصول إلى كل ما تضمنه خطة برو (Cloud)، باستثناء الدعم من فريقنا الأساسي. الدعم متاح عبر مجتمعنا في Discord.
إذا كنت تريد الاستضافة الذاتية وتحتاج إلى الميزات المتميزة (SSO وأذونات على مستوى السجل والمزيد)، فيمكنك اختيار ترخيص Organization (الاستضافة الذاتية) المدفوع. يشمل ذلك أيضًا دعمًا من فريق Twenty ويلغي شرط نشر الشيفرة المخصصة كمصدر مفتوح قبل التوزيع.
</Accordion>
<Accordion title="ما هي الميزات المتميزة؟">
لا تتوفر الميزات المتميزة إلا في خطط Organization (السحابة أو الاستضافة الذاتية):
* **تكامل SSO**: تسجيل الدخول الأحادي مع موفر الهوية لديك
* **أذونات على مستوى السجل**: تحكم دقيق في الوصول على مستوى السجل
* **بيانات استخدام الذكاء الاصطناعي**: تتبع استهلاك الذكاء الاصطناعي عبر مساحة العمل
* **سجلات التدقيق**: تحقق مما كان يفعله كل عضو في مساحة العمل
* **حملات البريد الإلكتروني**: خطط لرسائل البريد الإلكتروني التي يجب إرسالها (ستتوفر قريبًا)
* **مساحات عمل غير محدودة**: أنشئ عددًا غير محدود من مساحات العمل كما تريد (الاستضافة الذاتية فقط)
* **رمز المصدر الخاص**: لا يتطلب نشر التغييرات إلى مستودع متاح للعموم (مستضاف ذاتيا فقط)
</Accordion>
<Accordion title="هل تخطط المنظمة السحابية والمنظمة المستضيفة ذاتيا لنفس الخطط؟">
كلتاهما تقدمان الميزات المتميزة نفسها. ومع ذلك، لا يمكن استخدام اشتراك السحابة لعمليات النشر ذاتية الاستضافة. يتطلب النشر ذاتي الاستضافة مفتاح Enterprise.
</Accordion>
<Accordion title="هل تقدمون مقاعد مجانية للمستخدمين العارضين فقط؟">
نحن لا نقدم مقاعد مجانية. التسعير لكل مستخدم ويحتاج كل مستخدم إلى ترخيص للوصول إلى 20.
</Accordion>
<Accordion title="أين يمكنني تبديل اشتراكي إلى خطة المؤسسة؟">
يمكنك القيام بذلك ضمن `Settings → Billing → Plans`. ثم انقر على `التبديل إلى المؤسسة`.
</Accordion>
<Accordion title="أين يمكنني تبديل اشتراكي إلى الخطة الاحترافية؟">
يمكنك القيام بذلك ضمن `Settings → Billing → Plans`. ثم انقر على `Switch to Pro`.
</Accordion>
<Accordion title="أين يمكنني تبديل اشتراكي إلى سنوي؟">
يمكنك القيام بذلك ضمن `الإعدادات → الفوترة`. ثم انقر على `Upgrade to yearly`.
</Accordion>
<Accordion title="أين يمكنني تبديل اشتراكي إلى شهري؟">
يمكنك القيام بذلك ضمن `الإعدادات → الفوترة`. ثم انقر على `Downgrade to monthly`.
</Accordion>
<Accordion title="أين يمكنني رؤية استخدام الرصيد الخاص بي؟">
ستجد ذلك ضمن `الإعدادات → الفوترة`.
</Accordion>
<Accordion title="كم عدد أرصدة سير العمل لدينا؟">
يعتمد عدد الأرصدة على دورة الفوترة لديك، وليس على خطتك:
* **الاشتراكات الشهرية**: 5 أرصدة شهريًا
* **الاشتراكات السنوية**: 50 رصيدًا سنويًا
</Accordion>
<Accordion title="كيف يعمل استهلاك رصيد سير العمل؟">
يستهلك كل إجراء سير عمل الرصيد بناءً على تعقيده.
* **العمليات الداخلية الأساسية** (مثل البحث أو التحديث أو إنشاء السجلات) تستهلك أرصدة قليلة جدا
* **عمليات أكثر تعقيدًا** مثل عقد الشيفرة والطلبات إلى الخدمات الخارجية تستهلك مزيدًا من الأرصدة
* **مطالبات الذكاء الاصطناعي (AI prompts)** تستهلك أيضًا المزيد من الأرصدة بناءً على الاستخدام
* **التطبيقات** تستهلك أيضًا المزيد من الاعتمادات بشكل مماثل لشفرة العقد
يتم خصم الأرصدة في الوقت الفعلي عند تنفيذ سير العمل أو التطبيقات. يمكنك متابعة استخدامك في **الإعدادات → الفوترة** لمتابعة الاستهلاك والأرصدة المتبقية.
</Accordion>
<Accordion title="هل يمكنني شراء المزيد من أرصدة سير العمل؟">
تستطيع شراء أرصدة إضافية ضمن `الإعدادات → الفوترة`.
</Accordion>
<Accordion title="هل يمكنني شراء المزيد من أرصدة سير العمل لمدة شهر واحد فقط؟">
نعم، انتقل إلى 'الإعدادات → الفوترة ، انقر فوق زر 'زيادة' ، اختر عدد الاعتمادات التي تريدها ، وتأكيدها. سيتم تطبيقها لفترة الفوترة الحالية. ثم انقر فوق زر 'زيادة' مرة أخرى، قم بتغيير القيمة مرة أخرى إلى الأصل، وتأكيد - سيتم تطبيق تخفيض الرتبة ابتداء من فترة الفوترة التالية.
</Accordion>
</AccordionGroup>
## الفوترة
<AccordionGroup>
<Accordion title="أين يمكنني إدارة تفاصيل الفوترة؟">
يمكنك القيام بذلك ضمن `الإعدادات → الفوترة`.
</Accordion>
<Accordion title="أين يمكنني تحديث طريقة الدفع الخاصة بي؟">
يمكنك القيام بذلك ضمن `الإعدادات → الفوترة`. ثم انقر على `عرض تفاصيل الفوترة`. ستتمكن من إضافة طريقة دفع جديدة هناك.
</Accordion>
<Accordion title="أين يمكنني تحديث معلومات الفوترة الخاصة بي؟">
يمكنك القيام بذلك ضمن `الإعدادات → الفوترة`. ثم انقر على `عرض تفاصيل الفوترة`. ستتمكن من تعديل معلومات الفوترة هناك.
</Accordion>
<Accordion title="أين يمكنني الوصول إلى فواتيري؟">
يمكنك القيام بذلك ضمن `الإعدادات → الفوترة`. ثم انقر على `عرض تفاصيل الفوترة`. سترى جميع فواتيرك في أسفل الشاشة.
</Accordion>
<Accordion title="لماذا يختلف عدد المقاعد عن عدد المستخدمين في مساحة العمل الخاصة بي؟">
تتم مزامنة عدد المقاعد في مساحة العمل مع نظام الدفع كل 6 ساعات؛ وتُعدَّل الفواتير بناءً على الفارق.
</Accordion>
<Accordion title="لماذا تلقيت فاتورة مقابل عضو جديد في مساحة العمل؟">
عند إضافة عضو جديد في فضاء العمل إلى مكان العمل، ترسل فاتورة لتغطية الفرق. عند إزالة أحد أعضاء مساحة العمل، يتم تطبيق التغيير في الفاتورة الشهرية/السنوية القياسية التالية.
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,39 @@
---
title: الفوترة
description: تعرّف على تسعير Twenty وأدِر اشتراكك.
---
تقدّم Twenty خطط تسعير مرنة لتلبية احتياجات فريقك. أدِر اشتراكك، وتتبع أرصدة سير العمل، واطّلع على الفواتير — وكل ذلك من **Settings → Billing**.
## ما الذي يتضمنه هذا القسم
<CardGroup cols={2}>
<Card title="خطط التسعير" icon="tags" href="/l/ar/user-guide/billing/القدرات/خطط التسعير">
تعرّف على خطط تسعير Twenty وما تتضمنه.
</Card>
<Card title="الأسئلة الشائعة" icon="circle-question" href="/userer-guide/billing/how-tos/billing-faq">
أسئلة شائعة حول التسعير والفوترة.
</Card>
</CardGroup>
## نظرة سريعة
| الخطة | الميزات الرئيسية |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **مجانًا (مستضاف ذاتيًا)** | جميع ميزات Pro، ودعم المجتمع |
| **Pro (سحابي)** | كل شيء باستثناء ميزات Premium ‏(SSO، أذونات على مستوى الصف والمزيد)، دعم قياسي |
| **المؤسسة (سحابي)** | كل ما في Pro + ميزات Premium ‏(SSO، أذونات على مستوى الصف والمزيد)، دعم بأولوية |
| **المؤسسة (مستضاف ذاتيًا)** | كل ما في Pro + ميزات Premium ‏(SSO، أذونات على مستوى الصف والمزيد)، دعم فريق Twenty، غير مطلوب منك نشر التعليمات البرمجية المخصصة الخاصة بك كمصدر مفتوح قبل توزيعها |
## إجابات سريعة
**أين أدير الفوترة؟**
انتقل إلى **Settings → Billing** لعرض خطتك، وتحديث طرق الدفع، والوصول إلى الفواتير.
**هل يمكنني استخدام Twenty مجانًا؟**
نعم! استضف Twenty ذاتيًا واحصل على جميع ميزات Pro دون تكلفة.
**كيف أقوم بالترقية؟**
انتقل إلى **Settings → Billing** ثم انقر **Switch to Organization** أو **Switch to Yearly**.
لمزيد من الأسئلة، راجع [الأسئلة الشائعة حول الفوترة](/l/ar/user-guide/billing/how-tos/billing-faq).

View File

@@ -0,0 +1,43 @@
---
title: تقويم
description: فهم ميزات تكامل التقويم في Twenty.
---
**ملاحظة**: لربط تقويمك وتكوين إعدادات المزامنة، قم بزيارة [إعدادات البريد الإلكتروني والتقويم](/l/ar/user-guide/calendar-emails/overview).
## كيف يعمل تكامل التقويم
يقوم Twenty بمزامنة أحداث تقويمك تلقائيًا وربطها بسجلات CRM ذات الصلة، ما يمنحك عرضًا كاملاً لسجل اجتماعاتك مع جهات الاتصال والشركات.
## علامة تبويب التقويم
بجانب علامة تبويب البريد الإلكتروني في السجلات، ستجد علامة تبويب `التقويم` التي تحتوي على سجلّ الاجتماعات المجدولة المرتبطة بذلك السجل.
### متاح لـ
* **الأشخاص**: عرض جميع الاجتماعات المجدولة مع جهة اتصال محددة
* **الشركات**: راجع جميع الاجتماعات المتعلقة بشركة وموظفيها
* **الفرص**: الوصول إلى سجل الاجتماعات المتعلق بالشركة المرتبطة بالفرصة
### عرض تاريخ الاجتماعات
1. **انتقل إلى سجل**: انتقل إلى أي سجل لشخص، شركة، أو فرصة
2. **اختر علامة تبويب التقويم**: انقر على علامة التبويب `التقويم` بجانب علامة البريد الإلكتروني
3. **تصفح تاريخ الاجتماعات**: عرض جميع الاجتماعات المجدولة وتفاصيلها
4. **الوصول إلى سياق الاجتماع**: شاهد المشاركين في الاجتماع، الأوقات، والمعلومات ذات الصلة
## إعدادات الرؤية
تتبع بيانات التقويم نفس إعدادات الرؤية الخاصة بالبريد الإلكتروني، مما يضمن ضوابط خصوصية متسقة عبر كلتا قناتي التواصل.
## ما الذي يتم مزامنته
* **الاجتماعات الخارجية**: جميع الاجتماعات مع جهات الاتصال خارج مؤسستك
* **الربط التلقائي**: ترتبط الاجتماعات بسجلات الأشخاص والشركات الحالية بناءً على عناوين البريد الإلكتروني للحضور
* **تفاصيل الاجتماع**: الموضوع، الوقت، المدة، والمشاركون
* **التحديثات**: تتم مزامنة أحداث التقويم الجديدة تلقائيًا
## ما لا يتم مزامنته
* **الاجتماعات الداخلية**: تبقى الاجتماعات مع الزملاء فقط (نفس النطاق) خاصة
* **الأحداث الخاصة**: الأحداث المعلَّمة كخاصة في تقويمك

View File

@@ -0,0 +1,102 @@
---
title: صندوق البريد
description: فهم ميزات تكامل البريد الإلكتروني في Twenty.
---
**ملاحظة**: لربط حسابات البريد الإلكتروني الخاصة بك وتكوين إعدادات المزامنة، قم بزيارة [إعدادات البريد الإلكتروني والتقويم](/l/ar/user-guide/calendar-emails/overview).
## كيف تعمل تكاملات البريد الإلكتروني
يربط Twenty تلقائيًا رسائل البريد الإلكتروني الواردة من صناديق البريد المتصلة بالسجلات ذات الصلة في إدارة علاقات العملاء (CRM)، مما يحافظ على تاريخ جميع الاتصالات في مكان واحد.
### الكائنات التي يمكن العثور على رسائل البريد الإلكتروني فيها
تظهر المحادثات البريدية في ثلاثة أشياء رئيسية:
* **الأشخاص**: عرض جميع رسائل البريد الإلكتروني التي تم تبادلها مع جهة اتصال محددة
* **الشركات**: راجع جميع رسائل البريد الإلكتروني المتعلقة بالشركة وموظفيها
* **الفرص**: الوصول إلى رسائل البريد الإلكتروني ذات الصلة بالشركة المرتبطة بالفرصة. لم يتم عرض سلاسل البريد الإلكتروني من الأفراد في الفرصة حتى الآن.
### عرض سلاسل البريد الإلكتروني
1. **انتقل إلى سجل**: انتقل إلى أي سجل لشخص، شركة، أو فرصة
2. **اختر علامة تبويب البريد الإلكتروني**: انقر على علامة التبويب `البريد الإلكتروني` لعرض الرسائل المتزامنة
3. **افتح سلسلة رسائل البريد الإلكتروني**: انقر على أي رسالة بريد إلكتروني لفتحها وقراءة المحادثة بالكامل
4. **تصفح التاريخ**: انتقل عبر السجل الكامل للبريد الإلكتروني مع تلك الجهة
<img src="/images/user-guide/emails/show-inbox.png" style={{width:'100%'}} />
## ما ستراه
### عرض سلسلة البريد الإلكتروني
عند فتح سلسلة بريد إلكتروني، يمكنك:
* **قراءة المحادثات بالكامل**: شاهد تبادلات البريد الإلكتروني الكاملة
* **عرض المشاركين**: شاهد جميع الأشخاص المشاركين في سلسلة البريد الإلكتروني
* **تحقق من الأوقات المرسلة**: تعرف على الأوقات التي تم فيها إرسال كل بريد إلكتروني بالضبط
* **الوصول إلى السياق**: افهم التاريخ الكامل للاتصالات
### رؤية البريد الإلكتروني
بناءً على إعدادات صندوق البريد الخاص بك، قد ترى:
* **المحتوى الكامل**: نص البريد الإلكتروني الكامل والتفاصيل
* **الموضوع + البيانات الوصفية**: سطر الموضوع، المرسل، المتلقي، والتوقيت
* **البيانات الوصفية فقط**: معلومات أساسية بدون محتوى البريد الإلكتروني
## سلوك مزامنة البريد الإلكتروني
### معدل المزامنة
يقوم Twenty باستيراد رسائل البريد الإلكتروني بمعدل يقارب **400 رسالة في الدقيقة**. يُقيَّد هذا المعدل حاليًا بواسطة تقييد المعدل في Gmail API (وينطبق بالمثل على الموفّرين الآخرين).
للمرجع:
* 1,000 رسالة بريد إلكتروني → ~2.5 دقيقة
* 10,000 رسالة بريد إلكتروني → ~25 دقيقة
* 50,000 رسالة بريد إلكتروني → ~ساعتين
### ما الذي يتم مزامنته
* **البريد الخارجي**: كافة رسائل البريد الإلكتروني مع جهات الاتصال خارج مؤسستك
* **ربط تلقائي**: رسائل البريد الإلكتروني تتصل بسجلات الأشخاص والشركات الحالية
* **عناوين متعددة**: رسائل البريد الواردة من أي عنوان ترتبط بسجل جهة الاتصال نفسه
* **التحديثات**: تظهر رسائل البريد الإلكتروني الجديدة فورًا
### ما لا يتم مزامنته
* **الرسائل الإلكترونية الداخلية**: بشكل افتراضي، تبقى الرسائل الإلكترونية بين الزملاء (نفس النطاق) خاصة (يتم ضبطها في الإعدادات → عام → الأمان)
* **البريد الجماعي**: يتم استبعاد قوائم التوزيع والرسائل البريدية الجماعية
* **المجلدات المستبعدة**: يتم استبعاد المجلدات التي اخترت عدم مزامنتها (تم تكوينها تحت الإعدادات → الحسابات → البريد الإلكتروني)
### البريد الإلكتروني الداخلي
اختر ما إذا كانت الرسائل الإلكترونية الداخلية تتم مزامنتها في Twenty:
1. اذهب إلى **الإعدادات → عام → الأمان**
2. بدّل إعداد **مزامنة الرسائل الإلكترونية الداخلية** تشغيلًا/إيقافًا
### مزامنة المجلدات الانتقائية
تحكم بما تم مزامنته من مجلدات البريد الإلكتروني مع Twenty:
1. انتقل إلى **الإعدادات → الحسابات** ثم اختر حساب البريد الإلكتروني المتصل
2. قم بإعداد المجلدات ضمن قسم البريد الإلكتروني
3. اختر مجلدات معينة لتضمينها أو استبعادها (البريد الوارد، المرسل، الأرشيف، المجلدات المخصصة)
## استكشاف مشكلات مزامنة البريد الإلكتروني
### مشكلات المزامنة الشائعة
* **تأخير المزامنة**: تظهر رسائل البريد الإلكتروني فورًا، ولكن قد تستغرق عمليات الاستيراد الأولية وقتًا أطول
* **غياب رسائل البريد الإلكتروني**: تحقق مما إذا:
* المجلدات مستبعدة في إعدادات مجلد الرسائل
* تم تعطيل إنشاء جهة الاتصال تلقائيًا (البريد الإلكتروني يحتاج إلى سجلات Twenty موجودة)
* البريد الإلكتروني من زملاء العمل (نفس النطاق) أو قوائم المجموعات
* صندوق البريد لا يزال يكمل المزامنة الأولية
### قيود البريد الإلكتروني
* **المجلدات النظامية**: قد لا تكون بعض مجلدات البريد الإلكتروني متاحة للمزامنة
* **الأسماء المستعارة**: يمكن توصيل حسابات البريد الفعلية فقط (وليس الأسماء المستعارة البريدية)

View File

@@ -0,0 +1,25 @@
---
title: هل يمكنني حجز الاجتماعات من Twenty؟
description: معلومات حول حجز الاجتماعات مباشرةً من Twenty.
---
## الحالة الحالية
تم تصميم تكامل التقويم الخاص بـ Twenty لِـ **مزامنة وعرض** أحداث التقويم الموجودة لديك.
## جدولة الاجتماعات عبر سير العمل
في حين أنه من غير الممكن جدولة الاجتماعات يدويا، يمكنك جدولتها في 20 باستخدام سير العمل.
1. إنشاء سير عمل جديد
2. حدد أي مُشغِّل بناءً على احتياجاتك
3. أضف عقدة **Create Calendar Event**
4. قم بتكوين جميع البيانات اللازمة
5. فعّل سير العمل
## ما الذي يمكنك فعله
* **عرض سجل الاجتماعات** على سجلات الأشخاص والشركات والفرص
* **عرض الاجتماعات القادمة** مع جهات الاتصال ضمن نظام إدارة علاقات العملاء (CRM)
* **تتبُّع سياق الاجتماعات** جنبًا إلى جنب مع اتصالات البريد الإلكتروني
* **إنشاء جهات اتصال تلقائيًا** من مشاركي الاجتماعات

View File

@@ -0,0 +1,53 @@
---
title: هل يمكنني إرسال رسائل بريد إلكتروني من Twenty؟
description: معلومات حول إرسال رسائل البريد الإلكتروني مباشرةً من Twenty.
---
## الحالة الحالية
تم تصميم تكامل البريد الإلكتروني الخاص بـ Twenty لِـ **مزامنة وعرض** سجل بريدك الإلكتروني بالإضافة إلى كتابة الرسائل وإرسالها.
عند عرض سلسلة بريد إلكتروني في صفحة سجل والنقر على **Reply**، يمكنك كتابة رسالة بريد إلكتروني وإرسالها مباشرة.
## كيفية إرسال رسالة من Twenty
الشرط: حساب بريد متصل مع القدرة على إرسال رسائل البريد الإلكتروني
1. افتح قائمة الأوامر باستخدام اختصار **Ctrl+K** أو **Cmd+K**
2. انقر فوق خيار "إنشاء البريد الإلكتروني"
3. اختر المستلمين، أضف الموضوع والجسم والمرفقات إلى بريدك الإلكتروني
4. انقر على زر "إرسال" لإرسال البريد الإلكتروني
## ما الذي يمكنك فعله اليوم
* **عرض سجل البريد الإلكتروني** على سجلات الأشخاص والشركات والفرص
* **قراءة سلاسل البريد الإلكتروني كاملة** مع جهات الاتصال ضمن نظام إدارة علاقات العملاء (CRM)
* **تتبُّع سياق الاتصالات** إلى جانب أحداث التقويم
* **إنشاء جهات اتصال تلقائيًا** من تفاعلات البريد الإلكتروني
* **الرد عبر إعادة التوجيه** — انقر على Reply للانتقال إلى صندوق بريدك
## إرسال رسائل البريد الإلكتروني عبر سير العمل
يمكنك **إرسال رسائل البريد الإلكتروني تلقائياً باستخدام سير العمل**. هذا مفيد من أجل:
* متابعات تلقائية
* إشعارات لجهات الاتصال
* اتصالات مُحفَّزة بناءً على تغييرات السجل
تُرسل رسائل البريد الإلكتروني عبر سير العمل من خلال حساب صندوق البريد المتصل لديك.
→ تعرّف على [إجراء إرسال البريد الإلكتروني](/l/ar/user-guide/workflows/capabilities/workflow-actions#send-email)
## تسلسلات البريد الإلكتروني والنشرات الإخبارية
بالنسبة لتسلسلات البريد الإلكتروني والنشرات الإخبارية، نوصي باستخدام سير العمل لربط Twenty بأداة مخصّصة للتسويق عبر البريد الإلكتروني.
<Warning>
لا ينبغي إرسال رسائل بريد إلكتروني جماعية مباشرةً من صندوق بريدك لحماية سمعة نطاقك. استخدم أداة مخصّصة للاتصالات الجماعية.
</Warning>
→ اطّلع على [كيفية إرسال الرسائل عبر سير العمل](/l/ar/user-guide/workflows/capabilities/send-emails-from-workflows) للحصول على إرشادات الإعداد
## الخطط المستقبلية
إن إنشاء رسائل البريد الإلكتروني محليًا من داخل Twenty مُدرج على خارطة الطريق لدينا. انضم إلى [نقاشات GitHub](https://github.com/twentyhq/twenty/discussions) لمشاركة حالة الاستخدام الخاصة بك والمساعدة في تحديد أولوية هذه الميزة.

View File

@@ -0,0 +1,35 @@
---
title: هل يمكنني تتبّع نشاط البريد الإلكتروني على جميع الكائنات؟
description: فهم تتبّع نشاط البريد الإلكتروني عبر كائنات مختلفة.
---
## الكائنات المدعومة
يتوفر نشاط البريد الإلكتروني حالياً على **ثلاثة كائنات قياسية**:
| كائن | ما ستراه |
| ----------- | ------------------------------------------------------------------------------------------ |
| **الأشخاص** | جميع رسائل البريد الإلكتروني المتبادلة مع جهة الاتصال المحددة |
| **الشركات** | جميع رسائل البريد الإلكتروني مع أي شخص من تلك الشركة (استناداً إلى نطاق البريد الإلكتروني) |
| **الفرص** | رسائل البريد الإلكتروني المتعلقة بالشركة المرتبطة بالفرصة |
## لماذا هذه الكائنات فقط؟
الأشخاص والشركات والفرص هي كائنات العلاقات الأساسية حيث يضيف سياق البريد الإلكتروني أكبر قيمة. يتم ربط سلاسل البريد الإلكتروني تلقائياً بناءً على:
* **عنوان البريد الإلكتروني** → تتم مطابقته مع سجلات الأشخاص
* **نطاق البريد الإلكتروني** → تتم مطابقته مع سجلات الشركة
* **علاقة الشركة** → ترتبط بالفرص
## كائنات مخصصة
**تتبّع البريد الإلكتروني غير متاح على الكائنات المخصصة** في الوقت الحالي.
إذا كنت بحاجة إلى سياق البريد الإلكتروني على كائن مخصص، ففكّر في:
* استخدام حقل علاقة لربط كائنك المخصص بالأشخاص أو الشركات
* عرض سجل البريد الإلكتروني في سجل الأشخاص/الشركة المرتبط
## الخطط المستقبلية
يجري النظر في توسيع إمكانية عرض البريد الإلكتروني لتشمل الكائنات المخصصة. شارِك حالة الاستخدام الخاصة بك على [نقاشات GitHub](https://github.com/twentyhq/twenty/discussions) للمساعدة في تحديد أولوية هذه الميزة.

View File

@@ -0,0 +1,42 @@
---
title: ربط عدة صناديق بريد لكل مستخدم
description: اربط عدة حسابات بريد إلكتروني لمستخدم واحد.
---
## نظرة عامة
يدعم Twenty **عدد غير محدود من حسابات البريد الإلكتروني لكل مستخدم**. هذا مفيد إذا كنت تدير عدة صناديق بريد وارد، مثل:
* بريد العمل الشخصي + صندوق وارد مشترك للفريق
* عدة عناوين بريد إلكتروني موجهة للعملاء
* حسابات بريد إلكتروني مختلفة لأدوار مختلفة
## كيفية إضافة صناديق بريد متعددة
1. اذهب إلى **الإعدادات → الحسابات**
2. انقر على **إضافة حساب**
3. قم بتوصيل حساب غوغل أو مايكروسوفت، أو أي موفر بريد آخر يدعم بروتوكولات IMAP/SMTP
4. قم بتكوين إعدادات المزامنة لهذا الصندوق
5. كرر ذلك لكل صندوق بريد تريد ربطه
## إدارة حسابات متعددة
لكل صندوق بريد متصل إعداداته الخاصة:
* **عرض البريد الإلكتروني**: اختر ما يمكن لزملائك رؤيته
* **الإنشاء التلقائي لجهات الاتصال**: تمكين/تعطيل لكل صندوق بريد
* **اختيار المجلدات**: اختر المجلدات التي تريد مزامنتها
## كيف تظهر رسائل البريد الإلكتروني
تتم مزامنة رسائل البريد الإلكتروني من جميع صناديق البريد المتصلة لديك مع Twenty وتظهر في:
* **سجلات الأشخاص**: بناء على عنوان البريد الإلكتروني لجهة الاتصال
* **سجلات الشركات**: بناء على نطاق البريد الإلكتروني
* **الفرص**: بناء على الشركة المرتبطة
<Note>تُظهر كل رسالة بريد أي صندوق بريد تم إرسالها منه أو استلامها فيه، بحيث يمكنك تتبع الحساب الذي استُخدم في كل تواصل.</Note>
## ملاحظات مهمة
<Warning>يمكن ربط صناديق البريد الحقيقية فقط. لا يمكن ربط الأسماء المستعارة للبريد الإلكتروني التي تعيد التوجيه إلى صندوق بريد آخر بشكل منفصل — ستتم مزامنتها عبر صندوق البريد الرئيسي.</Warning>

View File

@@ -0,0 +1,53 @@
---
title: لا أرى رسائل البريد الإلكتروني على السجلات
description: استكشاف أخطاء رسائل البريد الإلكتروني المفقودة على السجلات وإصلاحها.
---
## أسباب شائعة
### 1. لا تزال المزامنة الأولية قيد التنفيذ
تستغرق مزامنة البريد الإلكتروني وقتًا، خاصةً لصناديق البريد الكبيرة. يقوم Twenty باستيراد رسائل البريد الإلكتروني بمعدل يقارب **400 رسالة في الدقيقة** (محدود بتقييد المعدل من Gmail API).
* **مزامنة التقويم**: تكتمل خلال دقائق
* **مزامنة البريد الإلكتروني**: تعتمد على حجم صندوق البريد (مثال: 10,000 رسالة ≈ 25 دقيقة، 50,000 رسالة ≈ ساعتان)
**الحل**: انتظر حتى يكتمل الاستيراد الأولي. يمكنك تقدير الوقت استنادًا إلى حجم صندوق بريدك.
### ٢. جهة الاتصال غير موجودة في Twenty
تظهر رسائل البريد الإلكتروني فقط في سجلات الأشخاص الموجودة. إذا لم يتم إنشاء جهة الاتصال بعد:
* فعّل **الإنشاء التلقائي لجهات الاتصال** في إعدادات صندوق بريدك
* أو أنشئ سجل الشخص يدويًا أولًا
**الحل**: انتقل إلى **Settings → Accounts**، واختر صندوق بريدك، وفعّل الإنشاء التلقائي لجهات الاتصال.
### 3. رسائل البريد الإلكتروني الداخلية مستبعدة
لا تتم مزامنة رسائل البريد الإلكتروني بين الزملاء (نفس نطاق البريد الإلكتروني) مطلقًا حفاظًا على الخصوصية.
**الحل**: هذا سلوك متوقع. لا تتم مزامنة سوى رسائل البريد الإلكتروني الخارجية.
### 4. البريد الإلكتروني من مجموعة أو قائمة توزيع
رسائل البريد الإلكتروني الخاصة بالمجموعات وقوائم التوزيع مستبعدة من المزامنة.
**الحل**: هذا سلوك متوقع.
### 5. المجلد غير محدد للمزامنة
إذا كنت تستخدم ميزة مجلد الرسائل، فقد تكون بعض المجلدات مستبعدة.
**الحل**: انتقل إلى **Settings → Accounts**، واختر صندوق بريدك، وتحقق من إعدادات مزامنة المجلدات.
### 6. عنوان البريد الإلكتروني في السجل غير صحيح
قد يحتوي سجل الشخص على عنوان بريد إلكتروني مختلف عن العنوان المستخدم في البريد الإلكتروني.
**الحل**: أضف عنوان البريد الإلكتروني الصحيح إلى سجل الشخص.
## ما يزال لا يعمل؟
1. جرّب فصل صندوق بريدك وإعادة توصيله
2. تواصل مع الدعم إذا استمرت المشكلات

View File

@@ -0,0 +1,58 @@
---
title: تقييد رسائل البريد الإلكتروني المُستوردة
description: تحكّم في أي رسائل بريد إلكتروني تُستورد إلى Twenty.
---
## نظرة عامة
افتراضيًا، يقوم Twenty بمزامنة جميع رسائل البريد الإلكتروني الخارجية من صندوق البريد المتصل لديك. يمكنك تقييد ما يتم استيراده باستخدام **اختيار المجلدات** و**إعدادات الرؤية**.
## الطريقة 1: اختيار المجلدات (مُوصى بها)
تحكم بما تم مزامنته من مجلدات البريد الإلكتروني مع Twenty:
1. اذهب إلى **الإعدادات → الحسابات**
2. اختر حساب البريد الإلكتروني المتصل لديك
3. اختر المجلدات التي تريد مزامنتها:
| مجلد | الوصف |
| --------------------- | --------------------------------- |
| **صندوق الوارد** | الرسائل الواردة الأساسية |
| **المرسلة** | رسائل البريد الصادرة التي أرسلتها |
| **الأرشيف** | الرسائل المؤرشفة |
| **المجلدات المخصّصة** | أي مجلدات محددة تريدها |
4. استبعِد المجلدات التي لا تريد مزامنتها (الرسائل غير المرغوب فيها، المهملات، المجلدات الشخصية)
<Note>هذا يمنحك تحكّمًا دقيقًا في الرسائل التي تظهر في CRM الخاص بك دون مزامنة كل شيء.</Note>
## الطريقة 2: إعدادات الإنشاء التلقائي لجهات الاتصال
تحكّم في وقت إنشاء جهات الاتصال من رسائل البريد الإلكتروني:
1. اذهب إلى **الإعدادات → الحسابات**
2. اختر صندوق البريد المتصل لديك
3. اختر خيارًا:
* **معطَّلة**: لن يتم إنشاء جهات اتصال، لكن ستُزامَن الرسائل مع جهات الاتصال الموجودة
* **المرسلة والمستلمة**: يتم إنشاء جهات اتصال من جميع رسائل البريد الإلكتروني الخارجية
* **المرسلة فقط**: يتم إنشاء جهات اتصال من الرسائل التي ترسلها فقط
## الرسائل الإلكترونية الداخلية
يمكن مزامنة الرسائل بين الزملاء (نفس النطاق) في Twenty:
1. اذهب إلى **الإعدادات → عام → الأمان**
2. بدّل **مزامنة الرسائل الإلكترونية الداخلية** بين التشغيل والإيقاف
<Note>بشكل افتراضي، يكون هذا الخيار معطّلًا.</Note>
## ما يتم استبعاده دائمًا
لا تتم مزامنة هذه الرسائل أبدًا، بغضّ النظر عن الإعدادات:
* **الرسائل الجماعية**: قوائم التوزيع والرسائل الجماعية
* **الرسائل غير المرغوب فيها/المهملات**: عادةً ما تُستبعَد مجلدات النظام
## ملاحظة مهمة
<Note>لا نوفر حتى الآن عنوان بريد إلكتروني في حقل CC لمزامنة البريد بشكل انتقائي. استخدم ميزة اختيار المجلدات أعلاه لتحقيق نفس مستوى التحكّم.</Note>

View File

@@ -0,0 +1,144 @@
---
title: الرزنامة و رسائل البريد الإلكتروني
description: قم بتوصيل بريدك الإلكتروني وحسابات التقويم إلى عشرين حسابا.
---
## خيارات الاتصال
### حساب Google (Gmail وتقويم Google)
1. اذهب إلى **الإعدادات → الحسابات**
2. انقر على **إضافة حساب**
3. حدد **متابعة مع جوجل**
4. السماح لـ Twenty بالوصول إلى Gmail وتقويم Google الخاص بك
5. تكوين إعدادات مزامنة البريد الإلكتروني (الرؤية ، الإنشاء التلقائي) → انقر فوق **التالي**
6. تكوين إعدادات مزامنة التقويم (الرؤية ، الإنشاء التلقائي) → انقر فوق **إضافة حساب**
7. ستبدأ رسائل البريد الإلكتروني وفعاليات التقويم بالمزامنة تلقائيًا
### حساب Microsoft (Outlook وتقويم Microsoft)
1. اذهب إلى **الإعدادات → الحسابات**
2. انقر على **إضافة حساب**
3. حدد **متابعة مع مايكروسوفت**
4. السماح لـ Twenty بالوصول إلى Outlook وتقويم Microsoft الخاص بك
5. تكوين إعدادات مزامنة البريد الإلكتروني (الرؤية ، الإنشاء التلقائي) → انقر فوق **التالي**
6. تكوين إعدادات مزامنة التقويم (الرؤية ، الإنشاء التلقائي) → انقر فوق **إضافة حساب**
7. ستبدأ رسائل البريد الإلكتروني وفعاليات التقويم بالمزامنة تلقائيًا
### إعداد IMAP/SMTP/CalDAV (مزودون آخرون)
بالنسبة لمزودي البريد الإلكتروني والتقويم الآخرين:
1. اذهب إلى **الإعدادات → الحسابات**
2. قم بتهيئة إعدادات IMAP لمزامنة رسائل البريد الإلكتروني الواردة وإعدادات SMTP لإرسال البريد الإلكتروني
3. قم بتكوين إعدادات CalDAV للتقويم
4. اختبر الاتصال
<Note>
**الاستضافة الذاتية على شبكة معزولة هوائيًا أو شبكة داخلية**: بشكل افتراضي، يرفض Twenty الاتصالات الصادرة إلى عناوين IP الخاصة/الداخلية (حماية SSRF). إذا كان خادم البريد أو التقويم يعمل على عنوان IP محلي/خاص (مثل خادم داخلي على شبكة LAN)، فسيتم حظر الاتصالات به. للسماح بهذه الاتصالات، قم بتعيين متغير البيئة التالي على الخادم:
```
OUTBOUND_HTTP_SAFE_MODE_ENABLED=false
```
هذا يعطّل الوضع الآمن لكل طلبات الإرسال الصادرة (**HTTP workflow actions**، و **webhooks**، واتصالات **IMAP/SMTP/CalDAV**)، لذا لا تقم بتفعيله إلا على الشبكات المعزولة والموثوقة حيث لا تكون حماية SSRF مطلوبة.
</Note>
### صناديق بريد متعددة
* **حسابات غير محدودة**: ربط حسابات بريد إلكتروني متعددة لكل مستخدم
* **إدارة الحسابات**: التبديل بين صناديق بريد مختلفة
* **إعدادات المزامنة**: تكوين إعدادات مختلفة لكل صندوق بريد
<Warning>
لا يمكن ربط إلا صناديق البريد الحقيقية (مثل support@domain.com بصندوق الوارد الخاص بها). لا يمكن ربط الأسماء المستعارة للبريد الإلكتروني التي توجه إلى صندوق بريد آخر بـ Twenty.
</Warning>
## تكوين البريد الإلكتروني
### ظهور الرسائل
اختر مستويات مختلفة من الظهور لرسائل بريدك الإلكتروني:
* **البيانات الوصفية فقط**: مشاركة المعلومات الأساسية فقط (المرسل، المستلم، التاريخ، الوقت)
* **العنوان والبيانات الوصفية**: مشاركة سطر العنوان مع البيانات الوصفية
* **محتوى البريد الإلكتروني الكامل**: مشاركة محتوى البريد الإلكتروني بالكامل بما في ذلك المرفقات
### الإنشاء التلقائي للاتصالات
* **معطل**: لا يتم إنشاء جهات اتصال تلقائيًا
* **للرسائل المرسلة والمستلمة**: إنشاء جهات اتصال لجميع تفاعلات البريد الإلكتروني الخارجية
* **للرسائل المرسلة فقط**: إنشاء جهات اتصال فقط لرسائل البريد التي ترسلها
* **ملاحظة**: بشكل افتراضي، لا تتم مزامنة الرسائل الإلكترونية الداخلية (عندما يشترك جميع المشاركين في نفس النطاق) لحماية الخصوصية
<Note>عند التمكين، يتم ربط جهات الاتصال تلقائيًا بسجلات الشركة الخاصة بها بناءً على نطاق بريدهم الإلكتروني. إذا لم تكن الشركة موجودة بعد، فستقوم Twenty بإنشائها لك.</Note>
<Note>
**مزامنة الرسائل الإلكترونية الداخلية**: سلوك "عدم مزامنة الرسائل الإلكترونية الداخلية" هو السلوك الافتراضي، ولكن يمكن إيقافه. مفتاح التبديل موجود في الإعدادات المتقدمة:
1. افتح **الإعدادات** وفعّل مفتاح التبديل **المتقدمة** في أسفل صفحة الإعدادات
2. اذهب إلى **عام → الأمان**
3. فعّل مفتاح التبديل **مزامنة الرسائل الإلكترونية الداخلية** لتضمين الرسائل الإلكترونية التي يشترك فيها جميع المشاركين في نفس النطاق
هذا إعداد على مستوى مساحة العمل (مفيد للجامعات أو المؤسسات ذات النطاق المشترك).
</Note>
### التحكم بالرسائل التي تتم مزامنتها من خلال اختيار مجلد الرسائل
تحكم بما تم مزامنته من مجلدات البريد الإلكتروني مع Twenty:
1. انتقل إلى **الإعدادات → الحسابات** ثم حدِّد حساب بريدك الإلكتروني المتصل.
2. اختر المجلدات التي تريد مزامنتها:
* **البريد الوارد**: رسائل البريد الأولية الواردة
* **بريد مرسل**: رسائل البريد الصادرة التي قمت بإرسالها
* **مجلدات مخصصة**: أي مجلدات محددة تريد تضمينها
* **استبعاد المجلدات**: تخطي المجلدات مثل الرسائل غير المرغوب فيها، المهملات، أو المجلدات الشخصية
هذا يمنحك التحكم الدقيق في الرسائل التي تظهر في CRM الخاص بك دون مزامنة كل شيء.
**ما الذي يتم مزامنته:**
* **رسائل البريد الخارجية**: جميع رسائل البريد الإلكتروني مع جهات اتصال خارجية من المجلدات المحددة
* **الرسائل الداخلية**: لا تتم مزامنتها بشكل افتراضي (تبقى رسائل البريد من نفس النطاق خاصة). فعّل مفتاح التبديل **المتقدمة** في أسفل **الإعدادات**، ثم شغّل **مزامنة الرسائل الإلكترونية الداخلية** ضمن **عام → الأمان** لتضمينها على مستوى مساحة العمل.
* **المرفقات**: ستأتي في النصف الأول من 2026
**ملاحظة**: لا نقدم عنوان بريد إلكتروني لنسخة كربونية للمزامنة الانتقائية. بدلاً من ذلك، استخدم ميزة مجلد الرسائل المذكورة أعلاه لتحقيق نفس مستوى التحكم حول أي الرسائل يتم مزامنتها مع Twenty.
## تكوين التقويم
### ظهور الفعاليات
اختر ما سيكون مرئيًا للمستخدمين الآخرين في مساحة العمل الخاصة بك:
* **كل شيء**: سيتم مشاركة تفاصيل الحدث بأكملها مع فريقك
* **بيانات التعريف**: فقط التاريخ والمشاركين سيتم مشاركتهم مع فريقك
### الإنشاء التلقائي للاتصالات للاجتماعات
* **نعم**: إنشاء جهات اتصال تلقائيًا للمشاركين في الاجتماعات الذين ليسوا في CRM الخاص بك
* **لا**: ربط الاجتماعات فقط بجهات الاتصال الموجودة
<Note>عند التمكين، يتم ربط جهات الاتصال تلقائيًا بسجلات الشركة الخاصة بها بناءً على نطاق بريدهم الإلكتروني. إذا لم تكن الشركة موجودة بعد، فستقوم Twenty بإنشائها لك.</Note>
### التحكم في الأحداث التي يتم مزامنتها
* **استيراد الاجتماعات**: استيراد فعاليات التقويم تلقائيًا
* **ربط الاتصال**: ربط الاجتماعات بسجلات الأشخاص والشركات
**ما الذي يتم مزامنته:**
* **الاجتماعات**: فعاليات التقويم مع المشاركين الخارجيين
* **ربط الاتصال**: يتم ربط الأحداث تلقائيًا بسجلات إدارة علاقات العملاء
* **فعاليات الفريق**: ظهور تقويم مشترك
## تردد المزامنة
**التحديثات كل 5 دقائق**: تتم مزامنة البيانات البريدية والتقويمية تلقائيًا كل 5 دقائق بعد الاستيراد الأولي.
<Note>
**توقيت المزامنة الأولية**: يكتمل تزامن التقويم بسرعة (عادةً خلال دقائق)، بينما تستغرق مزامنة البريد الإلكتروني وقتاً أطول لصناديق البريد الكبيرة. يقوم Twenty باستيراد رسائل البريد الإلكتروني بمعدل يقارب **400 رسالة في الدقيقة** (محدود بتقييد المعدل من Gmail API)، لذا فإن صندوق بريد يحتوي على 10,000 رسالة يستغرق حوالي 25 دقيقة. لا تقلق إذا كنت ترى جهات اتصال من أحداث التقويم تظهر قبل جهات الاتصال بالبريد الإلكتروني الخاص بك؛ هذا سلوك طبيعي.
</Note>
## الخطوات التالية
* [قدرات صندوق البريد](/l/ar/user-guide/calendar-emails/capabilities/mailbox)
* [كشف الأخطاء في البريد الإلكتروني المفقودة](/l/ar/user-guide/calendar-emails/how-tos/i-dont-see-emails-on-records)

View File

@@ -0,0 +1,275 @@
---
title: إعدادات المخطط
description: اضبط مخططاتك لعرض البيانات بالطريقة التي تحتاجها تمامًا.
---
import { ChartIcon } from '/snippets/chart-icon.mdx';
## الوصول إلى إعدادات المخطط
1. انقر زر **تحرير** في الزاوية العلوية اليمنى من لوحة المعلومات لديك
<img src="/images/user-guide/dashboard/dashboard-edit.png" alt="وضع التحرير" />
2. تدخل لوحة المعلومات وضع التحرير
3. انقر على أي عنصر واجهة لاختياره
4. تُفتح لوحة الإعدادات على اليمين
تُنظَّم الإعدادات في أقسام:
* **البيانات**: ما البيانات التي سيتم جلبها وكيفية تصفيتها
* **المحور X**: كيفية تجميع الفئات وفرزها (المخططات الشريطية/الخطية)
* **المحور Y**: ما الذي سيتم قياسه وكيفية عرضه (المخططات الشريطية/الخطية)
* **النمط**: الألوان، التسميات، والخيارات المرئية
<Note>
تظهر بعض الإعدادات فقط عند تهيئة إعدادات أخرى. على سبيل المثال، يظهر خيار **دقة التاريخ** فقط عند تحديد حقل تاريخ.
</Note>
---
## إعدادات البيانات
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="database" />المصدر </span>
اختر الكائن الذي تريد جلب البيانات منه.
1. انقر **المصدر**
2. حدِّد كائنًا (الفرص، الأشخاص، الشركات، إلخ.)
جميع كائناتك القياسية والمخصصة متاحة. يؤدي تغيير المصدر إلى إعادة تعيين الإعدادات الأخرى لأن خيارات الحقول تعتمد على الكائن المحدد.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-source.png" alt="المصدر" />
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="filter" />تصفية </span>
قيّد السجلات المضمّنة في المخطط.
1. انقر على **تصفية**
2. يُفتح مُنشئ عوامل التصفية
3. انقر **+ إضافة عامل تصفية**
4. حدِّد حقلًا وشرطًا وقيمة
5. أضِف المزيد من عوامل التصفية حسب الحاجة
تعمل عوامل التصفية بالطريقة نفسها كما في عروض الجداول. استخدمها للتركيز على شرائح محددة من بياناتك.
**مثال**: صفِّ الفرص حيث المرحلة تساوي "Won" لإظهار الصفقات المغلقة فقط.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-filters.png" alt="تصفية" />
<Tip>
بالنسبة لحقول التاريخ، جرّب **نسبي** لإنشاء عوامل تصفية ديناميكية مثل "آخر 7 أيام" أو "هذا الشهر" التي تتحدّث تلقائيًا.
</Tip>
<Tip>
تُدعم عوامل التصفية المتقدمة—أضِف قواعد تصفية متعددة وادمجها بمنطق **و** أو **أو**.
</Tip>
---
## إعدادات المحور X
تتحكم هذه الإعدادات في المحور الأفقي للمخططات الشريطية والخطية—وعادةً في كيفية تجميع بياناتك ضمن فئات.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="axis-x" />البيانات المعروضة </span>
اختر الحقل لتجميع بياناتك بحسبه. هذا يحدد الفئات المعروضة على المحور X.
**مثال**: اختر "Stage" لرؤية البيانات مُجمَّعة حسب مرحلة خط الأنابيب، أو "Created date" لرؤية البيانات عبر الزمن.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-x-data-on-display.png" alt="البيانات المعروضة" />
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="calendar" />دقة التاريخ </span>
عند التجميع حسب حقل تاريخ، اختر الفترة الزمنية للتجميع.
| الخيار | يُجمِّع البيانات حسب | مثال على المخرجات |
| ------------------ | --------------------------- | -------------------------------------------------------- |
| **يوم** | كل يوم تقويمي | 1 يناير، 2 يناير، 3 يناير... |
| **أسبوع** | أسابيع التقويم | الأسبوع 1، الأسبوع 2، الأسبوع 3... |
| **شهر** | أشهر التقويم | يناير، فبراير، مارس... |
| **ربع** | أرباع السنة المالية | الربع 1، الربع 2، الربع 3، الربع 4 |
| **عام** | سنوات التقويم | 2023، 2024، 2025 |
| **يوم من الأسبوع** | يوم من أيام الأسبوع (مجمّع) | الاثنين، الثلاثاء... (جميع أيام الاثنين مجتمعة) |
| **شهر من السنة** | شهر (مجمّع) | يناير، فبراير... (جميع أشهر يناير مجتمعة) |
| **ربع من السنة** | ربع (مجمّع) | الربع 1، الربع 2، الربع 3، الربع 4 (جميع الربع 1 مجتمعة) |
تُجمِّع خيارات "من الأسبوع/من السنة" عبر كل الوقت. استخدم **يوم من الأسبوع** لمعرفة أي يوم عادةً يحقق أكبر عدد من الصفقات. استخدم **شهر** لرؤية الاتجاهات شهرًا بشهر.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="arrows-sort" />الفرز حسب </span>
تحكّم بترتيب الفئات على المحور X.
* **الموضع** – يستخدم الترتيب المحدد في إعدادات حقل الاختيار
* **أبجديًا** – من A إلى Z (أو ترتيبًا زمنيًا للتواريخ)
* **حسب القيمة** – يُرتَّب بحسب المقياس (الأعلى أو الأدنى أولًا)
* **يدوي** – اسحب لضبط ترتيبك الخاص
<img src="/images/user-guide/dashboard/dashboard-chart-settings-x-sort.png" alt="الترتيب حسب" />
**نصيحة**: لمراحل خط الأنابيب، استخدم **الموضع** لعرض المراحل بترتيب عملية المبيعات لديك (Lead → Qualified → Proposal → Won).
<Note>
تعتمد الخيارات المعروضة على نوع الحقل لديك. حقول الاختيار تتضمن جميع الخيارات؛ حقول التاريخ والنص تعرض خيارات أقل.
</Note>
<Tip>
مع الفرز **اليدوي**، اسحب الفئات لإنشاء ترتيب مخصص—مناسب تمامًا لإبراز شرائح محددة أو سرد قصة ببياناتك.
</Tip>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="eye-off" />تجاهل القيم الصفرية </span>
أخفِ الفئات التي قيمتها صفر أو التي لا تحتوي بيانات.
* **تشغيل**: تُخفى الفئات التي لا تحتوي على سجلات
* **إيقاف**: تُعرض جميع الفئات حتى لو كانت فارغة
استخدم هذا لتنظيف المخططات ذات البيانات المتناثرة.
---
## إعدادات المحور Y
تتحكم هذه الإعدادات في ما تقوم بقياسه وكيفية عرضه.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="axis-y" />البيانات المعروضة </span>
اختر الحقل والعملية لحساب مقياسك.
* **العدد** – عدّ الكل، عدّ الفارغ، عدّ غير الفارغ، عدّ القيم الفريدة
* **الرياضيات** – المجموع، المتوسط، الحد الأدنى، الحد الأقصى (حقول الأرقام)
* **النِّسَب المئوية** – نسبة الفارغ، نسبة غير الفارغ
تضيف حقول القيم المنطقية عدّ true/false. تُظهر المخططات التجميعية مع حقول التاريخ الأقدم/الأحدث.
**مثال**: اختر "Amount" مع المجموع لرؤية إجمالي قيمة الصفقة لكل فئة، أو عدّ الكل لرؤية عدد الصفقات.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-data-on-display.png" alt="البيانات المعروضة" />
<Note>
تعتمد الخيارات المعروضة على نوع الحقل ونوع المخطط. إذا لم تر العملية المتوقعة، فتحقّق من نوع الحقل.
</Note>
### النسبة
بالنسبة لحقول الاختيار، ومتعدد الاختيار، أو القيم المنطقية، يمكنك حساب نسبة قيمة محددة.
1. اختر حقل اختيار، أو متعدد الاختيار، أو حقلًا منطقيًا
2. فعِّل **النسبة**
3. اختر الخيار المراد قياسه
**مثال**: اعرض الصفقات "Won" كنسبة مئوية من جميع الفرص. إذا كان لديك 10 "Won" من أصل 50 إجمالًا، فسيعرض المخطط 20٪.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="filters" />التجميع حسب </span>
أضِف بُعدًا ثانيًا لإنشاء عدة سلاسل (عدة أشرطة أو خطوط).
1. عيّن حقل المحور X أولًا
2. انقر **التجميع حسب**
3. اختر حقلًا ثانيًا
**مثال**: جمِّع الصفقات حسب المرحلة (المحور X) وأيضًا حسب المالك (التجميع حسب) لرؤية تفصيل خط الأنابيب لكل شخص جنبًا إلى جنب.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-group-by.png" alt="التجميع حسب" />
عند تعيين التجميع حسب، سترى ألوانًا متعددة في مخططك وستظهر وسيلة إيضاح.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="calendar" />دقة التاريخ </span>
عندما يكون التجميع حسب حقل تاريخ، اختر الفترة الزمنية (نفس خيارات المحور X).
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="arrows-sort" />الفرز حسب </span>
عند تفعيل **التجميع حسب**، تحكّم بترتيب السلاسل المجمّعة (مثلًا، أي شريط للمالك يظهر أولًا ضمن كل فئة).
نفس خيارات فرز المحور X—الموضع، أبجديًا، ويدوي—باستثناء أن **الفرز حسب القيمة غير متاح** للتجميع الثانوي.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="chart-bar-popular" />تراكمي </span>
اعرض المجاميع التراكمية بدلًا من القيم الفردية.
* **إيقاف**: يُظهر كل شريط/نقطة قيمته الخاصة
* **تشغيل**: يُظهر كل شريط/نقطة مجموع جميع القيم السابقة مضافًا إليها قيمته
**مثال**: يناير = 10، فبراير = 15
* التراكمي متوقف: يُظهر 10 و15
* التراكمي مفعّل: يُظهر 10 و25 (10 + 15)
استخدم التراكمي لتتبُّع التقدم نحو هدف عبر الزمن.
<img src="/images/user-guide/dashboard/dashboard-chart-settings-y-cumulative.png" alt="تراكمي" />
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="math-min" />المدى الأدنى / <ChartIcon icon="math-max" />المدى الأقصى </span>
عيّن قيمًا دنيا وعظمى ثابتة للمحور Y.
* اتركه فارغًا للتحجيم التلقائي
* أدخل رقمًا لتثبيت الحد
**متى يُستخدم:**
* عيّن الحد الأدنى إلى 0 للحصول على مقارنات مرئية دقيقة
* عيّن كليهما للحصول على مقاييس متسقة عبر عدة مخططات
* ركّز على نطاق قيم محدد بتعيين كليهما
---
## إعدادات النمط
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="color-swatch" />الألوان </span>
عيّن نظام الألوان لمخططك. اختر من مجموعة متنوعة من لوحات الألوان.
<Note>
عند التجميع حسب حقل اختيار، يستخدم المخطط تلقائيًا الألوان المحددة لكل خيار في إعدادات الحقل لديك.
</Note>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="gizmo" />اسم المحور </span>
اختر تسميات المحاور المراد عرضها: **لا شيء**، **المحور X**، **المحور Y**، أو **كلاهما** (للمخططات الشريطية والخطية فقط).
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="stack-2" />أشرطة مكدّسة / خطوط مكدّسة </span>
عند تعيين التجميع حسب، اختر كيفية عرض السلاسل المتعددة.
* **إيقاف (مجمّعة)**: تظهر السلاسل جنبًا إلى جنب. استخدم عند مقارنة القيم الدقيقة بين المجموعات.
* **تشغيل (مكدّسة)**: تتكدس السلاسل فوق بعضها. استخدم عند إظهار التركيب—كيف تتكوّن الأجزاء لتشكّل الكل.
**مثال**: صفقات حسب المرحلة، مُجمّعة حسب المالك
* مجمّعة: شاهد الأرقام الدقيقة لكل مالك جنبًا إلى جنب
* مكدّسة: شاهد إجمالي الصفقات لكل مرحلة، مع مساهمة كل مالك مكدّسة
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="badge-2k" />تسميات البيانات </span>
اعرض القيم مباشرة على عناصر المخطط (الأشرطة، النقاط، الشرائح).
* **تشغيل**: تظهر القيم على المخطط
* **إيقاف**: لا تُعرض قيم (مظهر أنظف)
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}> <ChartIcon icon="text-caption" />وسيلة الإيضاح </span>
إظهار أو إخفاء وسيلة الإيضاح (تظهر فقط عند تعيين التجميع حسب).
* **تشغيل**: تعرض وسيلة الإيضاح ما يمثله كل لون
* **إيقاف**: لا تُعرض وسيلة إيضاح
<Tip>
**مرّر المؤشر** فوق عنصر في وسيلة الإيضاح لإبراز تلك المجموعة. **انقر** لإخفائه مؤقتًا من المخطط.
</Tip>
---
## ملاحظات خاصة بالمخطط
### مخططات دائرية
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="chart-pie" size={16} /></span> **تمثل كل شريحة** – حدِّد كيفية تجميع الشرائح
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="eye-off" size={16} /></span> **إخفاء الفئة الفارغة** – إزالة الشرائح ذات القيمة الصفرية
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="number-123" size={16} /></span> **إظهار القيمة في الوسط** – عرض القيمة المجمّعة (المجموع، المتوسط، العدّ، إلخ.)
### مخططات التجميع
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="caret-left" size={16} /></span> **بادئة** – أضِف نصًا قبل الرقم (مثلًا، "$")
* <span style={{ display: 'inline-flex', verticalAlign: 'middle' }}><ChartIcon icon="caret-right" size={16} /></span> **لاحقة** – أضِف نصًا بعد الرقم (مثلًا، "%")

View File

@@ -0,0 +1,92 @@
---
title: لوحات القيادة
description: أنشئ ونظّم لوحات المعلومات باستخدام علامات تبويب لتصوّر بيانات إدارة علاقات العملاء (CRM) الخاصة بك.
---
## نظرة عامة
تُنظَّم لوحات المعلومات في Twenty بشكل هرمي: **لوحات المعلومات → علامات التبويب → عناصر واجهة المستخدم**. يمكن أن تحتوي كل لوحة معلومات على عدة علامات تبويب، وتحتوي كل علامة تبويب على عناصر واجهة مستخدم (مخططات، أرقام، iFrames).
## إنشاء لوحة معلومات
1. انتقل إلى **لوحات المعلومات** في شريط التنقل
2. انقر **+ سجل جديد**
<img src="/images/user-guide/dashboard/dashboard-create-new.png" alt="إنشاء لوحة تحكم جديدة" />
3. امنح لوحة المعلومات اسمًا
4. ابدأ بإضافة علامات تبويب وعناصر واجهة مستخدم
## العمل مع علامات التبويب
تساعدك علامات التبويب على تنظيم لوحة المعلومات في أقسام منطقية.
### إنشاء علامات تبويب
1. في وضع التحرير، انقر فوق **+** في شريط التبويب، وستفتح لوحة جانبية على اليمين
2. قم بتسمية علامة التبويب (مثل: "نظرة عامة على خط المبيعات"، "أداء الفريق")
3. أضف عناصر واجهة مستخدم إلى علامة التبويب
### إعادة ترتيب علامات التبويب
1. في وضع التحرير، انقر مع الاستمرار على علامة التبويب التي تريد نقلها
2. اسحب وأفلت إلى الموضع الجديد
3. يمكنك أيضا النقر على علامة التبويب واستخدام قائمة الأوامر لنقل علامة التبويب إلى اليسار أو اليمين
### حذف علامات التبويب
1. في وضع التحرير، انقر على علامة التبويب التي تريد حذفها
2. انقر على زر **حذف** في قائمة الأوامر
### تكرار علامات التبويب
1. انقر على علامة التبويب التي تريد تكرارها
2. انقر على زر **تكرار** في اللوحة الجانبية
<img src="/images/user-guide/dashboard/dashboard-tabs.png" alt="علامة تبويب لوحة التحكم" />
## تخطيط لوحة المعلومات
### ترتيب عناصر واجهة المستخدم
* اسحب وأفلت لتحديد الموضع
* غيّر الحجم لإبراز العناصر
* جمّع المخططات ذات الصلة معًا
### تكرار لوحة معلومات
1. حدِّد لوحة التحكم التي تريد تكرارها
2. افتح شريط الأوامر باستخدام **Cmd + K** (أو **Ctrl + K** على Windows)
3. اختر **تكرار لوحة المعلومات**
<img src="/images/user-guide/dashboard/dashboard-duplicate.png" alt="تكرار لوحة التحكم" />
### أفضل الممارسات
* **التسلسل المنطقي**: رتّب من النظرة العامة إلى التفاصيل
* **التسلسل البصري**: مخططات أكبر للمقاييس الرئيسية
* **تنسيق متّسق**: استخدم ألوانًا وخطوطًا متطابقة
## الظهور والوصول
### ظهور لوحة المعلومات
تكون لوحات المعلومات مرئية لجميع من لديهم حق الوصول إلى مساحة العمل الخاصة بك على Twenty. لا يتوفر خيار لوحة معلومات خاصة في الوقت الحالي.
### المفضلات
يمكنك إضافة لوحات المعلومات إلى المفضلة للوصول السريع. هذا إعداد شخصي—المفضلة الخاصة بك غير مرئية للمستخدمين الآخرين.
لإضافة لوحة معلومات إلى المفضلة، افتح لوحة المعلومات وانقر على أيقونة النجمة.
### سلوك المنطقة الزمنية
تعرض لوحات المعلومات حاليًا البيانات استنادًا إلى المنطقة الزمنية للمستخدم الذي يشاهدها. يعني هذا أن لوحة المعلومات نفسها قد تعرض مقاييس مختلفة لأعضاء الفريق في مناطق مختلفة (مثل: APAC مقابل US).
<Note>
**قريبًا**: سنضيف إمكانية تعيين منطقة زمنية محددة للوحة المعلومات، بحيث يرى جميع المستخدمين بيانات متسقة بغض النظر عن مواقعهم.
</Note>
<Note>
**قريبًا**: ستتيح عوامل التصفية على مستوى لوحة المعلومات تطبيق عوامل التصفية عبر جميع عناصر واجهة المستخدم دفعة واحدة، مما يجعل استكشاف بياناتك أسرع.
</Note>

View File

@@ -0,0 +1,169 @@
---
title: الأدوات
description: استكشف أنواع الأدوات وخيارات التصوّر في Twenty.
---
import { ChartIcon } from '/snippets/chart-icon.mdx';
## الأدوات المتاحة
يوفّر Twenty أنواعًا متعددة من الأدوات لتصوُّر بيانات إدارة علاقات العملاء (CRM).
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="chart-bar-popular" />مخططات الأعمدة</span>
اعرض البيانات كأعمدة أفقية أو عمودية.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-bar-chart.png" alt="مخطط أعمدة" />
</Frame>
**الأفضل لـ:**
* مقارنة القيم عبر الفئات
* عرض التصنيفات
* تتبّع المقاييس حسب الفترة الزمنية
**أمثلة على الاستخدام:**
* الصفقات حسب المرحلة
* الإيرادات حسب مندوب المبيعات
* جهات الاتصال المضافة شهريًا
<Note>
**حدود العرض**: يمكن لمخططات الأعمدة عرض حد أقصى يبلغ 100 عمود، و50 مجموعة لكل عمود عند استخدام "Group By". إذا ظهرت لك رسالة التحذير "بيانات غير معروضة: الحد الأقصى X عمودًا لكل مخطط"، فأضِف عوامل تصفية لتضييق نطاق بياناتك أو غيّر أسلوب التجميع (على سبيل المثال، اجعل التجميع حسب الأسبوع بدلًا من الأيام).
</Note>
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="chart-pie" />مخططات دائرية</span>
اعرض نسب الأجزاء من الكل.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-pie-chart.png" alt="مخطط دائري" />
</Frame>
**الأفضل لـ:**
* إظهار التركيب أو التوزيع
* مقارنة الأجزاء بالكل
* إبراز الشرائح الرئيسية
**أمثلة على الاستخدام:**
* توزيع الصفقات حسب المصدر
* تفصيل جهات الاتصال حسب الصناعة
* تركيب مسار المبيعات حسب المالك
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="chart-line" />مخططات خطية</span>
اعرض الاتجاهات مع مرور الوقت.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-line-chart.png" alt="مخطط خطي" />
</Frame>
**الأفضل لـ:**
* تتبّع التغيّرات مع مرور الوقت
* تحديد الاتجاهات
* مقارنة عدة مقاييس
**أمثلة على الاستخدام:**
* اتجاه عدد الصفقات شهريًا
* نمو الإيرادات على مدى الأرباع السنوية
* مستويات النشاط مع مرور الوقت
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="sum" />مخططات تجميعية</span>
اعرض القيم الأساسية المفردة بشكل بارز.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-aggregate-chart.png" alt="مخطط تجميعي" />
</Frame>
**الأفضل لـ:**
* إبراز مؤشرات الأداء الرئيسية
* عرض الإجماليات أو المتوسطات
* فحوصات سريعة للحالة
**أمثلة على الاستخدام:**
* القيمة الإجمالية لمسار المبيعات
* عدد الفرص المفتوحة
* معدل التحويل
**خيارات متقدمة:**
* **النسبة**: في حقول التحديد، احسب النِّسب بين القيم. اذهب إلى **البيانات المعروضة** → اختر حقلك → فعِّل خيار **النسبة**.
* **بادئة ولاحقة**: أضف نصًا مخصصًا قبل الرقم أو بعده (على سبيل المثال، "$" كبادئة أو "%" كلاحقة) لتحسين سهولة القراءة.
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="frame" />iFrames</span>
ضمّن الأدوات والمحتوى الخارجي مباشرةً في لوحة المعلومات الخاصة بك.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-table.png" alt="الجدول البياني" />
</Frame>
**الأفضل لـ:**
* البحث عن العناصر بشكل فردي
* التحقق من القيم الدقيقة
* التدقيق أو الرجوع كمرجع
**أمثلة على الاستخدام:**
* الصفقات التي تُغلق هذا الشهر
* العملاء المحتملون الجدد هذا الأسبوع
* الفواتير المتأخرة
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="table" />جدول</span>
اطّلع على السجلات المُفلترة مباشرة في لوحة المعلومات الخاصة بك.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-iframe.png" alt="iFrame" />
</Frame>
**الأفضل لـ:**
* عرض تقارير أو لوحات معلومات خارجية
* دمج أدوات المبيعات من جهات خارجية
* عرض محتوى مباشر من أنظمة أخرى
**أمثلة على الاستخدام:**
* مقاييس من أداة الدعم الخاصة بك
* مقاييس من أداة الاتصال الهاتفي لديك
* محتوى مباشر من أداة تسلسل المبيعات لديك
### <span style={{ display: 'inline-flex', alignItems: 'center', gap: '8px' }}><ChartIcon icon="align-box-left-top" />نص منسق</span>
أضف نصًا منسقًا ومحتوى مباشرةً إلى لوحة المعلومات الخاصة بك.
<Frame>
<img src="/images/user-guide/dashboard/dashboard-widget-rich-text.png" alt="نص منسق" />
</Frame>
**الأفضل لـ:**
* إضافة سياق أو إرشادات
* أوصاف لوحة المعلومات
* الملاحظات والتعليقات التوضيحية
**الميزات:**
* تنسيق النص المنسق (عريض، مائل، قوائم، إلخ.)
* رفع الصور والملفات
* تحرير بأسلوب Markdown
<Note>
**قريبًا**: مخططات القياس غير متاحة بعد ولكنها على خريطة الطريق لدينا.
</Note>
### تكرار الأدوات
1. انقر على الأداة
2. افتح **الخيارات**
3. انقر **تكرار الأداة**

View File

@@ -0,0 +1,54 @@
---
title: لوحة التحكم الأسئلة الشائعة
description: أسئلة شائعة حول لوحات القيادة في Twenty.
---
<AccordionGroup>
<Accordion title="هل يمكنني إنشاء لوحات قيادة خاصة؟">
لا، لوحات القيادة مرئية حاليًا لجميع من لديهم صلاحية الوصول إلى مساحة العمل الخاصة بك على Twenty. لوحات القيادة الخاصة غير متاحة بعد.
</Accordion>
<Accordion title="لماذا تبدو مقاييسي مختلفة عن مقاييس زميلي؟">
تعرض لوحات القيادة حاليًا البيانات بناءً على المنطقة الزمنية للعارض. إذا كنتم في مناطق مختلفة (على سبيل المثال، APAC مقابل US)، فقد ترون أرقامًا مختلفة قليلًا للوحة القيادة نفسها. نعمل على إضافة إعداد للمنطقة الزمنية لكل لوحة قيادة لضمان اتساق البيانات عبر الفرق.
</Accordion>
<Accordion title="هل يمكنني تصدير لوحة القيادة الخاصة بي؟">
تصدير لوحات القيادة غير متاح في الوقت الحالي. هذه الميزة مدرَجة على خارطة الطريق لدينا.
</Accordion>
<Accordion title="هل يمكنني مشاركة لوحات القيادة مع مستخدمين خارجيين؟">
لا، مشاركة لوحات القيادة مع المستخدمين خارج مساحة العمل الخاصة بك على Twenty (غير مستخدمي Twenty) غير مدعومة حاليًا.
</Accordion>
<Accordion title="كيف أضيف لوحة قيادة إلى المفضلة لدي؟">
افتح لوحة القيادة التي تريد إضافتها إلى المفضلة، ثم انقر على أيقونة النجمة. المفضلة شخصية — ولن تؤثر في المستخدمين الآخرين.
</Accordion>
<Accordion title="ما الفرق بين علامات التبويب وعناصر واجهة المستخدم؟">
* **علامات التبويب** تنظّم لوحة القيادة إلى أقسام (مثل صفحات داخل لوحة القيادة)
* **عناصر واجهة المستخدم** هي التصورات الفردية (مخططات، أرقام، وإطارات iFrame) داخل كل علامة تبويب
البنية: لوحة القيادة → علامات التبويب → عناصر واجهة المستخدم
</Accordion>
<Accordion title="هل يمكنني تصفية لوحة القيادة بالكامل دفعة واحدة؟">
عوامل التصفية على مستوى لوحة القيادة غير متاحة بعد، لكن هذه الميزة مدرَجة على خارطة الطريق لدينا. حاليًا، تحتاج إلى تطبيق عوامل التصفية على كل عنصر واجهة مستخدم على حدة.
</Accordion>
<Accordion title="هل مخططات القياس متاحة؟">
ليس بعد. مخططات القياس موجودة على خارطة الطريق الخاصة بنا وسيتم إضافتها في إصدار مستقبلي.
</Accordion>
<Accordion title="كيف أُكرّر لوحة قيادة؟">
1. تأكد من أنك في وضع العرض (وليس التحرير)
2. افتح شريط الأوامر باستخدام **Cmd + K** (أو **Ctrl + K** على Windows)
3. اختر **تكرار لوحة القيادة**
</Accordion>
<Accordion title="ما مدى تكرار تحديث بيانات لوحة القيادة؟">
تتحدّث عناصر واجهة المستخدم تلقائيًا مع تغيّر بيانات نظام إدارة علاقات العملاء (CRM):
* تحديثات فورية لمعظم المقاييس
* استخدم زر التحديث لإجراء تحديث يدوي عند الحاجة
* تُحفَظ البيانات التاريخية لتحليل الاتجاهات
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,67 @@
---
title: الأسئلة الشائعة حول الأداة
description: شرح الأسئلة الشائعة ورسائل الخطأ.
---
<AccordionGroup>
<Accordion title="كيف أعرض النسب المئوية بدلًا من الأعداد؟">
ثلاثة خيارات:
* **نسبة القيم الفارغة/غير الفارغة**: ضمن بيانات العرض، اختر نسبة القيم الفارغة أو نسبة القيم غير الفارغة
* **النسبة**: لحقول الاختيار أو خانات الاختيار، فعّل خيار النسبة لعرض خيار معيّن كنسبة مئوية من جميع السجلات
* **اللاحقة**: بالنسبة للمخططات التجميعية، أضف `%` كلاحقة في إعدادات النمط
</Accordion>
<Accordion title="ما الفرق بين الأعمدة المجمعة والمكدسة؟">
عند استخدام **التجميع حسب**، يمكنك عرض السلاسل بطريقتين:
* **مجمعة**: أعمدة جنبًا إلى جنب—الأفضل للمقارنة بين القيم الدقيقة
* **مكدسة**: أعمدة فوق بعضها—الأفضل لإظهار التركيب
بدّل خيار **مكدسة** في إعدادات النمط.
</Accordion>
<Accordion title="لماذا لا أرى خيارات المجموع أو المتوسط؟">
تعتمد العمليات المتاحة على **نوع الحقل**:
* **حقول الأرقام**: المجموع، المتوسط، الحد الأدنى، الحد الأقصى
* **حقول التاريخ**: الأقدم، الأحدث (للمخططات التجميعية فقط)
* **حقول خانات الاختيار**: عدّ 'صحيح'، عدّ 'خطأ'
إذا لم ترَ خيارًا، فتحقق من أنك اخترت نوع حقل متوافقًا.
</Accordion>
<Accordion title="لماذا تكون بعض الإعدادات باللون الرمادي أو مفقودة؟">
تظهر العديد من الإعدادات فقط عند استيفاء المتطلبات المسبقة:
* **دقة التاريخ**: حدد حقل تاريخ أولاً
* **التجميع حسب، وسيلة الإيضاح، مكدسة**: عيّن المصدر أولاً
* **أزرار تبديل وسيلة الإيضاح ومكدسة**: عيّن التجميع حسب أولاً
إذا كان إعداد مفقودًا، فقم بإعداد المتطلب المسبق له أولاً.
</Accordion>
<Accordion title="ماذا يعني 'No data'؟">
لم يعثر المخطط على سجلات مطابقة لإعداداتك.
**للحل:** أزل أو اضبط عوامل التصفية، وتحقق من أنك اخترت كائن المصدر الصحيح، أو تحقق من وجود سجلات لنطاق التاريخ الخاص بك.
</Accordion>
<Accordion title="ماذا يعني 'Invalid configuration'؟">
يوجد إعداد مطلوب مفقود أو غير متوافق.
**للحل:** تأكد من تعيين المصدر، وتكوين بيانات العرض، وتحديد أي حقول تجميع مطلوبة.
</Accordion>
<Accordion title="ماذا يعني 'Undisplayed data'؟">
تتجاوز بياناتك حدود العرض (100 عمود، 100 نقطة بيانات، أو 100 شريحة).
**للحل:** أضف عوامل تصفية لتضييق نطاق بياناتك، أو غيّر دقة التاريخ من يوم إلى أسبوع أو شهر.
</Accordion>
<Accordion title="لماذا لا يعرض أحد المحورين أي بيانات؟">
لا يحتوي الحقل المحدد على قيم للسجلات ضمن عامل التصفية لديك، أو أن نوع الحقل لا يطابق البيانات المتوقعة.
**للحل:** جرّب حقلًا آخر، أو تحقق من أن السجلات تحتوي على قيم للحقل المحدد.
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,75 @@
---
title: لوحات القيادة
description: تعلّم أساسيات إعداد التقارير ولوحات المعلومات في Twenty.
---
## فهم لوحات المعلومات
توفّر لوحات المعلومات في Twenty طريقة مرئية لتتبّع مقاييس الأداء الأساسية لديك واستخلاص الرؤى من بيانات إدارة علاقات العملاء (CRM) لديك.
<img src="/images/user-guide/dashboard/dashboards_v2.png" alt="لوحات القيادة" />
## المفاهيم الأساسية
### لوحات القيادة
لوحة المعلومات عبارة عن مجموعة من علامات التبويب التي تعرض بيانات إدارة علاقات العملاء (CRM) لديك بنظرة سريعة. يمكنك إنشاء عدة لوحات معلومات لأغراض مختلفة:
* أداء المبيعات
* نشاط الفريق
* صحة مسار الصفقات
* مقاييس مخصصة
### علامات التبويب
تتيح لك علامات التبويب تنظيم لوحة المعلومات إلى أقسام. تحتوي كل علامة تبويب على أداة واحدة أو أكثر.
### الأدوات
الأدوات هي تصورات مرئية فردية تعرض بيانات محددة. تشمل الأنواع:
* مخططات الأعمدة
* مخططات دائرية
* مخططات خطية
* مخططات التجميع
* iFrames
* نص منسق
<Note>
**القيود الحالية**:
* تصدير لوحات المعلومات ومشاركتها مع المستخدمين الخارجيين (غير مستخدمي Twenty) غير متاحين في الوقت الحالي.
* مخططات القياس غير متاحة بعد.
</Note>
## البدء
### إنشاء أول لوحة معلومات لك
1. انتقل إلى قسم **لوحات المعلومات**
2. انقر **+ لوحة معلومات جديدة**
3. امنح لوحة المعلومات اسمًا
4. أضِف علامات تبويب لتنظيم محتواك
5. أضِف أدوات لعرض بياناتك
6. حفظ
### إضافة أدوات
1. افتح علامة تبويب في لوحة المعلومات الخاصة بك
2. انقر **+ إضافة أداة**
3. اختر نوع الأداة
4. اختر مصدر البيانات (الكائن)
5. كوّن إعدادات الأداة
6. احفظ واعرض أداتك
## أفضل الممارسات
* **ابدأ ببساطة**: ابدأ ببعض المقاييس الأساسية وأضف المزيد مع مرور الوقت
* **ركّز على البيانات القابلة للتنفيذ**: اعرض المقاييس التي تقود اتخاذ القرارات
* **مراجعة منتظمة**: تحقّق من لوحات المعلومات بانتظام لاكتشاف الاتجاهات
* **المشاركة مع الفريق**: اجعل لوحات المعلومات مرئية لأعضاء الفريق المعنيين
## الخطوات التالية
* [الأدوات والتصورات](/l/ar/user-guide/dashboards/capabilities/widgets)
* [مرجع إعدادات المخطط](/l/ar/user-guide/dashboards/capabilities/chart-settings)
* [الأسئلة الشائعة حول لوحات المعلومات](/l/ar/user-guide/dashboards/how-tos/dashboards-faq)

View File

@@ -0,0 +1,76 @@
---
title: التعامل مع الأخطاء والتحقّق
description: راجع وأصلِح أخطاء الاستيراد مباشرةً في واجهة المستخدم قبل التأكيد.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## التحقّق قبل الاستيراد
بعد رفع ملفك وتعيين الحقول، تتحقّق Twenty من بياناتك **قبل** الاستيراد. يتيح لك ذلك اكتشاف الأخطاء وإصلاحها من دون التأثير في بياناتك الحالية.
## كيف يعمل
1. **ارفع** ملف CSV الخاص بك
2. **طابِق** أعمدتك مع حقول Twenty
3. **راجِع** الأخطاء المحتملة المميّزة باللون الأصفر
4. **أصلِح الأخطاء** مباشرةً في واجهة المستخدم
5. **أكِّد** عملية الاستيراد
<VimeoEmbed videoId="1145273857" title="عرض توضيحي بالفيديو" />
## عرض الأخطاء
يتم تمييز الصفوف التي تحتوي على مشكلات باللون **الأصفر**. يمكنك:
* **حرِّر الخلية مباشرةً** لإصلاح الخطأ
* **أزل الصف** لتجاوزه بالكامل
يوفّر هذا التحرير المضمَّن الوقت — لا حاجة للعودة إلى جدول البيانات، وإصلاح الأخطاء، وإعادة الرفع.
## أنواع الأخطاء الشائعة
### قيم مكرّرة
**السبب**: حقل فريد (البريد الإلكتروني، النطاق) موجود مسبقًا في Twenty أو يظهر مرتين في ملفك.
**الإصلاح**:
* حرِّر القيمة المكرّرة في واجهة مستخدم الاستيراد
* أزل أحد الصفوف المكرّرة
راجع [قيود التفرّد](/l/ar/user-guide/data-migration/capabilities/uniqueness-constraints) لمزيد من التفاصيل حول كيفية فرض التفرّد.
### تنسيق غير صالح
**السبب**: لا تتطابق البيانات مع التنسيق المتوقع (مثل: بريد إلكتروني غير صالح، تنسيق تاريخ غير صحيح).
**الإصلاح**: حرِّر الخلية لاستخدام التنسيق الصحيح.
راجع [تعيين الحقول](/l/ar/user-guide/data-migration/capabilities/field-mapping) لمعرفة التنسيق المتوقع لكل نوع من الحقول.
### حقول مطلوبة مفقودة
**السبب**: حقل مطلوب فارغ.
**الإصلاح**: أدخِل قيمة في الحقل المطلوب أو أزل الصف.
### العلاقة غير موجودة
**السبب**: السجل المشار إليه غير موجود (مثل: نطاق شركة لم يتم استيراده).
**الإصلاح**:
* استورِد سجلات الأصل أولًا
* أو صحِّح قيمة المرجع
راجع [استيراد العلاقات](/l/ar/user-guide/data-migration/capabilities/import-relations) لمعرفة ترتيب الاستيراد الصحيح وكيفية ربط السجلات.
## نصائح لتقليل الأخطاء
1. **تنزيل القالب** لرؤية التنسيق المتوقع قبل استيراد الملف الخاص بك
2. **نظِّف بياناتك** في جدول البيانات أولًا
3. **استورِد الملفات بالترتيب الصحيح** لاستيراد العلاقات (الشركات → الأشخاص → الفرص)
4. **اختبر بدُفعات صغيرة** قبل الاستيراد الكامل
5. **تحقّق من التكرارات** قبل الرفع
6. **الحد من كل ملف إلى 10,000 سجلا**

View File

@@ -0,0 +1,198 @@
---
title: تعيين الحقول
description: كيف يعمل تعيين الحقول أثناء استيراد البيانات.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## كيف يعمل تعيين الحقول
عند تحميل ملف، يقوم Twenty بتحليل أعمدتك ومحاولة مطابقتها مع الحقول الموجودة.
### التعيين التلقائي
يحاول Twenty مطابقة الأعمدة استنادًا إلى:
* أسماء رؤوس الأعمدة (مطابقات دقيقة أو متشابهة)
* اكتشاف نوع البيانات (تواريخ، أرقام، عناوين بريد إلكتروني)
* أنماط الحقول الشائعة
<Note>**نصيحة سريعة:** صدِّر بضعة صفوف من الكائن الذي تريد استيراده. سيحتوي الملف المصدَّر على أسماء الأعمدة الدقيقة التي يتوقعها Twenty، مما يجعل التعيين التلقائي سلسًا أثناء الاستيراد.</Note>
### خيارات التعيين اليدوي
لكل عمود، يمكنك:
* **تعيين إلى حقل**: اختر الحقل المطابق في Twenty من قائمة منسدلة
* **عدم التعيين**: تخطَّ العمود بالكامل (لن يتم استيراد البيانات)
<Note>**يجب أن تكون الحقول موجودة قبل الاستيراد.** الاستيراد يُنشئ السجلات، لا الحقول. أنشئ الحقول المخصصة ضمن **الإعدادات → نموذج البيانات** قبل الاستيراد.</Note>
## توافق أنواع الحقول
جميع أنواع الحقول المتاحة في نموذج البيانات مدعومة للاستيراد.
يمكنك أيضًا استيراد قيم `id` إما لتعيين معرّف محدد للسجلات الجديدة أو لتحديث السجلات القائمة.
<img src="/images/user-guide/fields/all-field-types.png" style={{width:'100%'}} />
## متطلبات تنسيق البيانات
<Note>**لبعض الحقول صياغة خاصة.** نوصي بتنزيل الملف النموذجي قبل إعداد عملية الاستيراد للاطلاع على الصياغة المتوقعة لكل نوع حقل.</Note>
### حقول العنوان
العنوان حقل متداخل يضم عدة أعمدة. يمكن ترك بعضِها فارغًا.
* **Address / Address 1**: سطر عنوان الشارع 1
* **Address / Address 2**: سطر عنوان الشارع 2
* **Address / City**: اسم المدينة
* **Address / State**: الولاية أو المقاطعة
* **Address / Country**: اسم الدولة
* **Address / Post Code**: الرمز البريدي/ZIP
### حقول المصفوفة
استخدم التنسيق التالي:
```
["value1","value2"]
```
### حقول القيم المنطقية
استخدم `TRUE` أو `FALSE` (أحرف كبيرة) - وليس `true` أو `false`
### حقول العملة
العملة حقل متداخل يحتوي على عمودين يجب **ملؤهما كلاهما**:
* **Amount / Amount**: القيمة الرقمية (مثال: `1234.56`)
* **Amount / Currency**: رمز العملة (مثال: `USD`، `EUR`)
### حقول التاريخ
التنسيقات المدعومة:
* `YYYY-MM-DD` (موصى به)
* `MM/DD/YYYY`
* `DD/MM/YYYY`
* تنسيق ISO 8601
### حقول النطاق
* يُوصى باستخدام التنسيق `https://domain.com` لتجنب إنشاء التكرارات، إذ إن هذا هو التنسيق المستخدم للشركات التي يتم إنشاؤها عبر مزامنة صندوق البريد والتقويم
* يمكن ملء حقلي `Domain Label` و`Domain URL`: وأفضل ممارسة هي وضع `domain.com` في التسمية و`https://domain.com` في عنوان URL
* يجب أن تكون النطاقات فريدة داخل كائن الشركات
* **يجب أن تكون النطاقات فريدة داخل الملف المُراد استيراده**
### حقول البريد الإلكتروني
* يجب أن تكون بتنسيق بريد إلكتروني صحيح
* يجب أن تكون عناوين البريد الإلكتروني فريدة داخل كائن الأشخاص
* **يجب أن تكون عناوين البريد الإلكتروني فريدة داخل الملف المُراد استيراده**
* للبريد الإلكتروني الإضافي: استخدم **Emails / Primary Email** للبريد الرئيسي، و**Emails / Additional Emails** بهذا التنسيق:
```
["jane@twenty.com","jane.doe@twenty.com"]
```
### حقول الهوية
تحديد `id` أثناء الاستيراد اختياري. يقوم Twenty بإنشاء واحد تلقائيًا إذا لم يتم توفيره.
حالات استخدام لتعيين عمود `id`:
* **تعيين معرّف محدد**: اختر UUID للسجلات التي سيتم إنشاؤها
* **تحديث السجلات الحالية**: طابِق السجلات الحالية لتحديثها بدلاً من إنشاء تكرارات. في هذه الحالة، يُنصح بعدم تعيين الحقول الفريدة الأخرى: فاقتصار التعيين على حقل فريد واحد يضمن عملية استيراد أكثر سلاسة.
<Note>إذا قدّمت قيمة `id`، فيجب أن تكون بتنسيق UUID (مثال: `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>
### حقول JSON
استخدم تنسيق JSON صالحًا:
```
{"key":"value","key2":"value2"}
```
### حقول الروابط
مشابه لحقول النطاق:
* املأ عمودي التسمية والرابط معًا: **Links / Link URL** و**Links / Link Label**
* استخدم تنسيق الرابط الكامل: `https://example.com`
* للروابط الثانوية، استخدم عمود **Links / Secondary Links** بهذا التنسيق:
```
[{"url":"https://twenty.com","label":"Twenty"}]
```
### حقول التحديد المتعدد
استخدم **أسماء واجهة برمجة التطبيقات (API)** (وليس تسميات العرض) بالتنسيق التالي:
```
["VALUE1","VALUE2"]
```
اطّلع [هنا](#finding-api-names-for-select-fields) لمعرفة مكان العثور على أسماء واجهة برمجة التطبيقات.
<Note>لن يتم إنشاء خيارات التحديد الجديدة تلقائيًا بواسطة الاستيراد. يجب إضافتها ضمن **الإعدادات → نموذج البيانات** قبل الاستيراد.</Note>
<Warning>
**استيراد الكتابات الزائدة؛ لا يضيف.**
إذا كان السجل يحتوي بالفعل على `VALUE2` و`VALUE3` محدّدين، ثم استوردت `["VALUE1"]`، فسيحتوي السجل على `VALUE1` فقط بعد الاستيراد. يتم استبدال التحديدات السابقة، وليس دمجها.
</Warning>
### حقول الأرقام
* أرقام فقط
* تُكتب الكسور العشرية بنقطة: `1234.56`
* من دون فواصل آلاف
### حقول الهاتف
الهاتف حقل متداخل يضم عدة أعمدة يجب **ملؤها**
* **Phones / Primary Phone Number**: رقم الهاتف (مثال: `4159095555`)
* **Phones / Primary Phone Country Code**: رمز الدولة (مثال: `US`)
* **Phones / Primary Phone Calling Code**: رمز الاتصال (مثال: `+1`)
### حقول التقييم
استخدم تنسيق اسم واجهة برمجة التطبيقات: `RATING_1`، `RATING_2`، `RATING_3`، `RATING_4`، `RATING_5`
### حقول العلاقات
يرجى الاطّلاع على مقالتنا المخصّصة: [استيراد العلاقات بين الكائنات](/l/ar/user-guide/data-migration/capabilities/import-relations)
### حقول الاختيار
استخدم **اسم واجهة برمجة التطبيقات** للخيار (وليس تسمية العرض):
```
VALUE1
```
اطلع [هنا](#finding-api-names-for-select-fields) على مكان العثور على أسماء واجهة برمجة التطبيقات.
<Note>لن يتم إنشاء خيارات الاختيار الجديدة تلقائيًا بواسطة الاستيراد. يجب إضافتها ضمن **الإعدادات → نموذج البيانات** قبل الاستيراد.</Note>
### الحقول النصية
* لا يلزم تنسيق خاص
* تُزال المسافات في البداية والنهاية
## العثور على أسماء واجهة برمجة التطبيقات
بالنسبة لحقول الاختيار، والاختيار المتعدد، والمصفوفة ذات الخيارات المحددة مسبقًا، يجب استخدام **أسماء واجهة برمجة التطبيقات**، وليس تسميات العرض.
### كيفية العثور على أسماء واجهة برمجة التطبيقات
1. اذهب إلى **الإعدادات → نموذج البيانات**
2. اختر الكائن والحقل
3. فعّل **الوضع المتقدم** (زر التبديل في أسفل يمين صفحة الإعدادات)
4. اعرض اسم واجهة برمجة التطبيقات لكل خيار
<VimeoEmbed videoId="1144910809" title="عرض توضيحي بالفيديو" />

View File

@@ -0,0 +1,48 @@
---
title: تنسيقات الملفات المدعومة
description: تنسيقات الملفات المدعومة لاستيراد البيانات في Twenty.
---
## التنسيقات المدعومة
يدعم Twenty ثلاث تنسيقات ملفات للاستيراد:
| التنسيق | الامتداد | الملاحظات |
| ---------------- | -------- | ----------------------- |
| **CSV** | .csv | موصى به، الأكثر توافقاً |
| **Excel** | .xlsx | تنسيق Excel الحديث |
| **Excel (قديم)** | .xls | تنسيق Excel الأقدم |
## متطلبات الملف
| متطلب | القيمة |
| ----------------------- | ------------------------------------------ |
| **الترميز** | يُوصى باستخدام UTF-8 |
| **الحد الأقصى للسجلات** | 10,000 سجل لكل ملف |
| **الهيكل** | يجب أن يحتوي الصف الأول على عناوين الأعمدة |
| **المحتوى** | نوع كائن واحد لكل ملف |
## أفضل الممارسات لملفات CSV
* **المحدد**: استخدم الفاصلة (`,`) أو الفاصلة المنقوطة (`;`)
* **محدد النص**: استخدم علامات الاقتباس المزدوجة (`"`) للنص الذي يحتوي على فواصل
* **نهايات الأسطر**: Windows (CRLF) أو Unix (LF) كلاهما مدعومان
* **القيم الفارغة**: اترك الخلايا فارغة، لا تستخدم "NULL" أو "N/A"
## أفضل الممارسات لبرنامج Excel
عند التصدير من Excel:
* أزل الصيغ (صدّر القيم فقط)
* احذف الصفوف الفارغة في النهاية
* تأكد من عدم وجود خلايا مدمجة
* استخدم الورقة الأولى فقط
## مجموعات البيانات الكبيرة
بالنسبة لمجموعات البيانات التي تزيد عن 10,000 سجل:
* قسّمها إلى عدة ملفات
* أو استخدم [الاستيراد عبر API](/l/ar/user-guide/data-migration/how-tos/import-data-via-api) لسجلات غير محدودة
<Note>بالنسبة لعمليات الترحيل الكبيرة جداً (100,000+ سجل)، تكون واجهة API أسرع بكثير وأكثر موثوقية من عمليات استيراد CSV.</Note>

View File

@@ -0,0 +1,148 @@
---
title: استيراد العلاقات بين الكائنات
description: استيراد العلاقات بين السجلات عبر CSV.
---
## نظرة عامة
يدعم Twenty استيراد العلاقات بين الكائنات أثناء استيراد CSV. يتيح لك هذا ربط السجلات (مثلًا، إرفاق الأشخاص بالشركات) كجزء من ترحيل البيانات.
<Note>**مدعوم حاليًا للاستيراد**: علاقات واحد إلى متعدد تشير إلى نوع كائن واحد على كل جانب (مثلًا، الأشخاص → الشركات). العلاقات التي تشير إلى أنواع كائنات متعددة غير مدعومة في الاستيراد/التصدير بعد.</Note>
## كيف تعمل العلاقات في Twenty
### واحد إلى متعدد / متعدد إلى واحد
يدعم Twenty العلاقات القياسية حيث يرتبط سجل واحد بعدّة سجلات أخرى:
* **شركة واحدة → العديد من الأشخاص**: يمكن أن تضم الشركة عدّة موظفين، لكن كل شخص ينتسب إلى شركة واحدة
* **شركة واحدة → العديد من الفرص**: يمكن أن تحتوي الشركة على عدّة صفقات، لكن كل فرصة تتبع شركة واحدة
### علاقات يمكن أن تشير إلى أنواع كائنات متعددة
يمكن لبعض العلاقات الاتصال بأنواع مختلفة من الكائنات. يعمل هذا بطريقتين:
**النمط 1: سجلات كثيرة يرتبط كلٌ منها بسجل واحد من أنواع كائنات مختلفة**
يمكن إرفاق عدة ملاحظات أو مهام بأنواع متعددة من الكائنات في وقت واحد:
* **الملاحظات** يمكن ربطها بشخص واحد وشركة واحدة وفرصة واحدة في الوقت نفسه
* **المهام** يمكن ربطها بشخص واحد وشركة واحدة وفرصة واحدة في الوقت نفسه
هنا تكون الملاحظات/المهام على جانب "المتعدد". يرتبط كلٌ منها بسجل واحد لكل نوع كائن.
<img src="/images/user-guide/fields/many-to-one-morph.png" style={{width:'100%'}} />
**النمط 2: سجل واحد يستقبل روابط من سجلات عديدة لأنواع كائنات مختلفة**
يمكن لمشروع أن يستقبل روابط من سجلات متعددة عبر أنواع كائنات مختلفة:
* **مشروع** يمكن أن يكون مرتبطًا به العديد من الأشخاص، والعديد من الشركات، والعديد من الملاحظات المرفقة به
هنا يكون المشروع على جانب "الواحد". يمكن لعدّة سجلات من كائنات مختلفة أن ترتبط جميعها بالمشروع نفسه.
<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
<Warning>
**قيد في الاستيراد/التصدير**: العلاقات التي تشير إلى أنواع كائنات متعددة (مثل الملاحظات → الأشخاص/الشركات/الفرص) **غير مدعومة بعد** في استيراد أو تصدير CSV.
* **الاستيراد**: يمكن استيراد علاقات واحد إلى متعدد فقط التي تشير إلى نوع كائن واحد على كل جانب
* **التصدير**: تُترك الأعمدة الخاصة بالعلاقات التي تشير إلى أنواع كائنات متعددة فارغة حاليًا
هذا على خارطة الطريق لدينا.
</Warning>
### ما ليس مدعومًا اليوم
**علاقات متعدد إلى متعدد** غير متاحة بعد. على سبيل المثال، لا يمكنك حاليًا إنشاء علاقة حيث:
* يرتبط العديد من الأشخاص بالعديد من المشاريع
<Note>العديد من العلاقات مخطط لها لـ H2 2026.</Note>
## ربط السجلات أثناء الاستيراد
<Note>**تذكير**: يمكن استيراد علاقات واحد إلى متعدد فقط التي تشير إلى نوع كائن واحد (مثلًا، الأشخاص → الشركات). العلاقات التي تشير إلى أنواع كائنات متعددة (مثل الملاحظات → الأشخاص/الشركات/الفرص) غير مدعومة بعد.</Note>
### الخطوة 1: تحديد جانبي "الواحد" و"المتعدد"
أولًا، حدّد أي الكائنات على جانب "الواحد" وأيها على جانب "المتعدد" في العلاقة.
**مثال**:
* **الشركة** هي جانب "الواحد" (شركة واحدة لديها العديد من الموظفين)
* **الأشخاص** على جانب "المتعدد" (ينتمي كل شخص إلى شركة واحدة)
### الخطوة 2: تأكّد من وجود سجلات جانب "الواحد"
قبل استيراد جانب "المتعدد"، يجب أن تكون سجلات جانب "الواحد" موجودة مسبقًا في Twenty.
* استورد أو أنشئ سجلات جانب "الواحد" أولًا (مثلًا، الشركات)
* تحقّق من مُعرّفهم الفريد. يمكن أن يكون ذلك:
* حقل `id` (UUID الخاص بـ Twenty)
* حقل مُعيّن كفريد (مثلًا، `domain` للشركات، أو مُعرّف خارجي من نظامك السابق)
<Warning>سيفشل الاستيراد إذا تمت الإشارة إلى سجل غير موجود.</Warning>
### الخطوة 3: جهّز ملف CSV الخاص بك
أضِف عمودًا في ملف CSV الخاص بجانب "المتعدد" يُشير إلى سجل جانب "الواحد".
**مثال**: لملف CSV للأشخاص يربط بالشركات:
```
firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co
```
**مهم**:
* يجب أن **يطابق تمامًا** قيمة الحقل الفريد في سجل الشركة
* بالنسبة للنطاقات، استخدم **عنوان النطاق (URL)** (مثلًا، `https://acme.com`)، وليس تسمية النطاق
* قم بتعيين **مُعرّف فريد واحد** فقط لكل علاقة: فهذا يؤدي إلى عملية استيراد أكثر سلاسة
### الخطوة 4: تأكّد من وجود حقل العلاقة
قبل رفع ملفك، تأكّد من وجود حقل العلاقة بين كائناتك.
إذا لم يكن موجودًا:
1. اذهب إلى **الإعدادات → نموذج البيانات**
2. اختر الكائن الخاص بك (مثلًا، الأشخاص)
3. أنشئ حقل علاقة يشير إلى الكائن الهدف (مثلًا، الشركة)
### الخطوة 5: ارفع الملف وعيّن العلاقة
1. ارفع ملف CSV عبر واجهة الاستيراد
2. في خطوة تعيين الحقول، اعثر على عمود العلاقة الخاص بك (مثلًا، `companyDomain`)
3. عيّنه على حقل العلاقة (مثلًا، الشركة)
4. سيقوم Twenty بربط كل سجل تلقائيًا بالأصل المطابق
### الحقول الفريدة المتاحة للعلاقات
| كائن | الحقول الفريدة المتاحة |
| ------------------------------ | -------------------------------- |
| **الشركات** | `id`، `domain`، أي حقل فريد مخصص |
| **الأشخاص** | `id`، `email`، أي حقل فريد مخصص |
| **أعضاء مساحة العمل** | `id`، `email` (ليس الاسم) |
| **كائنات قياسية ومخصّصة أخرى** | `id`، أي حقل مُعلَّم كفريد |
<Note>**الربط بأعضاء مساحة العمل**: عندما تشير العلاقة إلى أعضاء مساحة العمل (فريقك الذي يسجّل الدخول إلى Twenty)، فقم بالإشارة إليهم عبر **عنوان البريد الإلكتروني**، وليس الاسم.</Note>
<Note>نوصي باستخدام `domain` للشركات و`email` للأشخاص، إذ إنها مقروءة بشريًا وسهلة الإدارة في جداول البيانات.</Note>
<Note>**تذكير**: السجلات المحذوفة حذفًا غير نهائي (مرئية ضمن Command Menu → See deleted records) تُحتسب ضمن معايير التفرّد. إذا قمت باستيراد سجل بالقيمة الفريدة نفسها لسجل محذوف، فسيتم استعادة السجل المحذوف. راجع [قيود التفرّد](/l/ar/user-guide/data-migration/capabilities/uniqueness-constraints) لمزيد من التفاصيل.</Note>
## قاعدة ترتيب الاستيراد
<Warning>
**احرص دائمًا على استيراد جانب "الواحد" أولًا!**
1. **الشركات** أولًا (من دون تبعيات)
2. **الأشخاص** ثانيًا (مرتبطون بالشركات)
3. **الفرص** ثالثًا (مرتبطة بالشركات/الأشخاص)
4. **الكائنات المخصّصة** وفقًا لتبعياتها
يجب أن يكون السجل الأصل موجودًا قبل أن تتمكّن من الإشارة إليه.
</Warning>

View File

@@ -0,0 +1,72 @@
---
title: قيود التفرّد
description: كيف يفرض Twenty تفرد البيانات أثناء الاستيراد.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## نظرة عامة
يفرض Twenty التفرّد على حقول معيّنة لمنع تكرار السجلات وضمان سلامة البيانات. فهم هذه القيود أمرٌ أساسي لنجاح عمليات الاستيراد.
## الحقول الفريدة الافتراضية
| كائن | الحقول الفريدة |
| ---------------- | -------------------- |
| **الأشخاص** | `id`, `email` |
| **الشركات** | `id`, `domain` |
| **كائنات مخصصة** | `id` فقط (افتراضيًا) |
<Note>حقل `id` هو المعرّف الداخلي الخاص بـ Twenty، يتم إنشاؤه تلقائيًا لكل سجل. يستخدم تنسيق UUID (مثلًا: `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`).</Note>
## حقول فريدة مخصّصة
يمكنك تعريف حقول فريدة إضافية ضمن **الإعدادات → نموذج البيانات**:
1. اذهب إلى **الإعدادات → نموذج البيانات**
2. اختر الكائن
3. انقر على حقل
4. فعِّل **فريد** في إعدادات الحقل
### حالات استخدام للحقول الفريدة المخصّصة
* **معرّفات خارجية**: خزّن معرّفات من أنظمة أخرى (Salesforce ID, HubSpot ID)
* **معرّفات الأعمال**: أرقام الموظفين، رموز العملاء
* **معلومات اتصال بديلة**: ملف LinkedIn، رقم الهاتف
<Note>اسم الحقل `id` محجوز للمعرّف الداخلي الخاص بـ Twenty. استخدم اسمًا مختلفًا مثل `externalId` أو `legacyId` للمعرّفات الخارجية.</Note>
## سلوك الاستيراد
### إنشاء سجلات جديدة
إذا لم تكن قيمة الحقل الفريد موجودة، فسيتم إنشاء سجل جديد.
### تحديث السجلات الموجودة
إذا طابقت قيمة حقل فريد سجلًا موجودًا، فسيتم **تحديث** ذلك السجل بالبيانات الجديدة.
<Warning>لـ **تحديث السجلات الموجودة**، يُنصَح بـ **مطابقة حقل فريد واحد فقط**.</Warning>
### السجلات المحذوفة حذفًا غير نهائي
<Warning>
**السجلات المحذوفة تُحتسب ضمن التفرّد.**
السجلات المحذوفة حذفًا غير نهائي (مرئية ضمن Command Menu → See deleted records) مُدرجة ضمن فحوصات التفرّد. إذا قمت باستيراد سجل بالقيمة الفريدة نفسها لسجل محذوف، فسيتم **استعادة** السجل المحذوف مع البيانات الجديدة.
</Warning>
## اكتشاف التكرارات أثناء الاستيراد
أثناء مرحلة التحقق:
* يتم تمييز التكرارات داخل ملفك باللون الأصفر
* يمكنك تعديل الصفوف المكرّرة أو إزالتها من واجهة المستخدم قبل بدء الاستيراد
<VimeoEmbed videoId="1145246326" title="عرض توضيحي بالفيديو" />
## أفضل الممارسات
1. **أزل التكرارات** من ملفك قبل الاستيراد
2. **تحقّق من السجلات الموجودة** في Twenty قبل الاستيراد
3. **استخدم المعرّفات الخارجية** عند الترحيل من أنظمة أخرى
4. **ضمّن الحقول الفريدة** إذا كنت تريد تحديث السجلات الموجودة

View File

@@ -0,0 +1,32 @@
---
title: تصدير الأسئلة الشائعة
description: أسئلة متكررة حول تصدير البيانات.
---
<AccordionGroup>
<Accordion title="هل يمكننا تصدير جميع بيانات مساحة العمل قبل الإلغاء، بما في ذلك الأجسام المخصصة، الحقول المخصصة، العلاقات، الملاحظات، المهام، الفرص، المرفقات، سير العمل، الأذونات، سجل المراجعة؟">
يمكن تصدير بيانات حيز العمل قبل الإلغاء مع بعض الاستثناءات: يجب نقل لوحات التحكم وتدفقات العمل والأذونات يدويا؛ ولا يمكن نقل سجلات مراجعة الحسابات.
</Accordion>
<Accordion title="ما هي العناصر التي لا يمكن تصديرها أو نقلها حالياً؟">
ويمكن تصدير معظم العناصر أو نقلها مع بعض الاستثناءات:
* سير العمل، لوحة التحكم وجميع الإعدادات (API مفاتيح الويب، وسجلات المراجعة، وإعدادات المستخدم، وما إلى ذلك) يجب ترحيل يدوياً
* يمكن ترحيل الكائنات والحقول التي أنشأتها التطبيقات عن طريق تثبيت التطبيق المذكور في فضاء عمل مختلف. لا ينبغي ترحيل يدوياً
* بعض السجلات، مثل إصدارات سير العمل وتشغيل سير العمل، غير قابلة للتحويل على الإطلاق ومن المتوقع أن تفقد
* بعض الكائنات مثل الرسائل والأجسام المتصلة بالتقويم لا ينبغي تصديرها لأنها تنشأ عند توصيل الحساب ومزامنته بشكل دوري. سيتم مزامنتهم مرة أخرى بمجرد الاتصال بحسابك (ما دام لديك حق الوصول إلى الحساب المذكور). إذا كان حساباً لأحد أعضاء الفريق الذين غادروا شركتك ، فيجب تصدير هذه الرسائل وإلا فستفقد )
</Accordion>
<Accordion title="هل هناك سحابة رسمية على إجراءات الهجرة التي تستضيف نفسها أو خدمة هجرة مساعدة؟">
وحتى الآن، لا توجد إجراءات رسمية للهجرة تستضيف ذاتيا. والفكرة العامة هي:
* أولاً ، قم بتثبيت التطبيقات لتقديم الكائنات والحقول التي تملكها التطبيقات
* تكرار الكائنات والحقول المخصصة المضافة من قبل المستخدمين
* استخدام برنامج نصي مع مفاتيح API أو أدوات AI لنقل جميع البيانات من فضاء عمل إلى آخر
* يجب نقل جميع الأشياء غير القابلة للتحويل يدوياً
يرجى أن تكون على علم ببضعة أشياء:
* يمكنك إرسال ما يصل إلى 50 طلب في الدقيقة على خطة المحترفين أو 100 طلب في الدقيقة على خطة المنظمة قبل أن تضرب الحد الأقصى للطلب/الحد الأدنى
* كل طلب API يمكن أن يحتوي على ما يصل إلى 200 سجل
* بعض البيانات في الحقول مثل التي تم إنشاؤها بواسطة أنشطة الخط الزمني وتحديثها سيتم فقدها أثناء الاستيراد وكتابتها من قبل النظام
</Accordion>
<Accordion title="هل يتم تقديم الملفات المصدرة بصيغ مفتوحة وموثقة؟">
الملفات المصدرة في واجهة المستخدم بتنسيق Excel، ويمكن حفظ جميع طلبات API بتنسيق JSON.
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,209 @@
---
title: تصدير بياناتك
description: دليل كامل خطوة بخطوة لتصدير البيانات من Twenty.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## نظرة عامة
صدّر بيانات مساحة العمل الخاصة بك إلى CSV لأغراض النسخ الاحتياطي أو إعداد التقارير أو الترحيل.
**حالات الاستخدام:**
* **نسخ احتياطية منتظمة** — احتفظ بنسخ من بياناتك
* **تقارير خارجية** — حلّل البيانات في Excel وGoogle Sheets أو أدوات ذكاء الأعمال (BI)
* **الترحيل** — انقل البيانات إلى نظام آخر
* **تحديثات دفعيّة** — صدّر، ثم حرّر وأعد الاستيراد لتحديث السجلات
## ما تحتاج إلى معرفته
### حدود التصدير
* **حد أقصى 20,000 سجل** لكل عملية تصدير
* يتم تصدير **الأعمدة المرئية** فقط
* يتم تصدير **السجلات المصفّاة** فقط (استنادًا إلى العرض الحالي لديك)
<Note>بالنسبة لعمليات التصدير الأكبر (أكثر من 20,000 سجل)، استخدم عوامل التصفية للتصدير على دفعات أو استخدم [واجهة برمجة التطبيقات (API)](/l/ar/developers/extend/api).</Note>
### الصلاحيات
تحتاج إلى صلاحية **"تصدير CSV"** لتصدير البيانات. تواصل مع مشرف مساحة العمل إذا لم يكن هذا الخيار متاحًا لديك.
## الخطوة 1: الانتقال إلى الكائن
اذهب إلى الكائن الذي تريد تصديره:
* **الأشخاص** — لجهات الاتصال
* **الشركات** — للمؤسسات
* **الفرص** — للصفقات
* **كائنات مخصصة** — أي كائن قمت بإنشائه
## الخطوة 2: تهيئة العرض الخاص بك
**مهم:** يتضمن التصدير فقط ما هو مرئي في عرضك الحالي.
### إضافة/إزالة الأعمدة
1. انقر **الخيارات → الحقول** (أو **+** في نهاية الأعمدة)
2. حدّد الحقول التي تريد تصديرها
3. ألغ تحديد الحقول التي لا تحتاجها
### تصفية السجلات (اختياري)
إذا كنت تحتاج فقط إلى مجموعة فرعية من البيانات:
1. انقر على **تصفية**
2. أضف شروط التصفية (مثال: "تاريخ الإنشاء > 1 يناير 2024")
3. سيتم تصدير السجلات المطابقة فقط
### فرز السجلات (اختياري)
1. انقر على عنوان عمود للفرز
2. سيتبع التصدير ترتيب الفرز الذي اخترته
<Note>**أنشئ عرضًا مخصصًا للتصدير.** احفظ عرضًا مُهيّأً خصيصًا لعمليات التصدير حتى لا تحتاج إلى إعادة التهيئة في كل مرة.</Note>
## الخطوة 3: تصدير البيانات
1. انقر على أيقونة **⋮** في أعلى يمين الجدول
2. حدد **تصدير العرض**
3. اختر مكان حفظ ملف CSV
4. انتظر حتى يكتمل التنزيل
## ما الذي يتم تصديره
| متضمن | غير متضمن |
| --------------------------------------- | ---------------------------- |
| جميع الأعمدة المرئية | الأعمدة المخفية |
| السجلات المطابقة لعوامل التصفية الحالية | السجلات المُستبعدة بالتصفية |
| قيم الحقول المخصصة | الحقول غير الموجودة في العرض |
| معرّفات السجلات | مرفقات الملفات |
| معرّفات العلاقات | الصور |
### حقول العلاقات
يتم تصدير معرّفات العلاقات فقط على جانب "المتعدد" من العلاقة:
* **تصدير الأشخاص** يتضمن عمود `companyId` (علاقة الأشخاص → الشركة)
* **تصدير الشركات** لا يتضمن `peopleIds` (الشركات هي جانب "الواحد")
هذا يعني أنه يمكنك استخدام تصدير الأشخاص لإعادة الاستيراد والحفاظ على رابط الشركة، لكن ستحتاج إلى إعادة استيراد الأشخاص بعد الشركات لإعادة إنشاء العلاقات.
## التصدير لأغراض محددة
### للنسخ الاحتياطي
1. أنشئ عرضًا تكون فيه **جميع الحقول** مرئية
2. أزل جميع عوامل التصفية لتضمين كل السجلات
3. صدّر كل نوع من الكائنات على حدة
4. احفظ ملفات التصدير في موقع آمن
5. عيّن تذكيرًا متكررًا (أسبوعي/شهري)
### للتقارير الخارجية
1. ضمّن فقط الحقول التي تحتاجها للتحليل
2. طبّق عوامل تصفية للتركيز على البيانات ذات الصلة
3. فكّر في الفرز حسب الحقل الذي ستقوم بتحليله
### للتحديثات الدفعيّة
1. صدّر السجلات التي تريد تحديثها
2. ضمّن المعرّف الفريد (`email`، `domain`، أو `id`)
3. حرّر الملف المُصدَّر
4. أعد الاستيراد لتحديث السجلات
راجع: [كيفية تحديث السجلات الموجودة](/l/ar/user-guide/data-migration/how-tos/update-existing-records-via-import)
### للترحيل
إذا كنت تقوم بالتصدير للترحيل إلى نظام آخر:
1. **صدّر كل كائن على حدة** — الأشخاص، الشركات، الفرص، إلخ.
2. **ضمّن حقول المعرّف** — فهي تساعد في الحفاظ على العلاقات
3. **وَثِّق مطابقة الحقول** — دوّن كيفية توافق حقول Twenty مع نظامك المستهدف
## التعامل مع مجموعات بيانات كبيرة (أكثر من 20,000 سجل)
حد التصدير هو 20,000 سجل. بالنسبة لمجموعات البيانات الأكبر:
### الخيار 1: التصدير على دفعات
1. أضف عامل تصفية (مثال: نطاقات "تاريخ الإنشاء")
2. صدّر الدفعة الأولى
3. غيِّر عامل التصفية
4. صدّر الدفعة التالية
5. ادمج الملفات في تطبيق جداول البيانات لديك
**أمثلة لعوامل التصفية للتجميع على دفعات:**
* حسب النطاق الزمني (يناير، فبراير، مارس...)
* حسب المالك (عضو الفريق أ، عضو الفريق ب...)
* حسب الحالة (نشط، غير نشط...)
### الخيار 2: استخدام واجهة برمجة التطبيقات (API)
لا يوجد حد للسجلات في واجهة برمجة التطبيقات (API):
1. احصل على مفتاح API من **الإعدادات → المطوّرون**
2. استخدم واجهة برمجة تطبيقات GraphQL للاستعلام عن السجلات
3. عالج النتائج في تطبيقك
راجع: [وثائق واجهة برمجة التطبيقات (API)](/l/ar/developers/extend/api)
## نصائح وأفضل الممارسات
### إنشاء عروض للتصدير
احفظ عروضًا مُهيّأة خصيصًا لعمليات التصدير:
1. هيّئ الأعمدة وعوامل التصفية
2. انقر **خيارات العرض** → **حفظ كعرض جديد**
3. سمّه "تصدير - [الغرض]"
### أمّن عمليات التصدير الخاصة بك
قد تحتوي ملفات التصدير على بيانات حساسة:
* احفظها في مواقع آمنة
* احذف عمليات التصدير القديمة عندما لا تعود مطلوبة
* كن حذرًا عند مشاركة ملفات التصدير
### تحقّق قبل التصدير
<Check>الأعمدة الصحيحة مرئية</Check>
<Check>تم ضبط عوامل التصفية بشكل صحيح (أو تمت إزالتها للتصدير الكامل)</Check>
<Check>لديك صلاحية التصدير</Check>
## الأسئلة الشائعة
<AccordionGroup>
<Accordion title="لماذا تفتقد عملية التصدير بعض الأعمدة؟">
يتم تصدير الأعمدة المرئية فقط. أضف الأعمدة التي تحتاجها عبر **الخيارات → الحقول** قبل التصدير.
</Accordion>
<Accordion title="لماذا لا تحتوي عملية التصدير على جميع السجلات؟">
تحقّق من عوامل التصفية لديك. يتضمن التصدير فقط السجلات التي تطابق عوامل التصفية في عرضك الحالي. أزل عوامل التصفية لتصدير جميع السجلات.
</Accordion>
<Accordion title="هل يمكنني تصدير أكثر من 20,000 سجل؟">
ليس في عملية تصدير واحدة. استخدم عوامل التصفية للتصدير على دفعات، أو استخدم واجهة برمجة التطبيقات (API) لمجموعات البيانات الأكبر.
</Accordion>
<Accordion title="ما صيغة ملف التصدير؟">
CSV (قيم مفصولة بفواصل). يفتح في Excel أو Google Sheets أو أي تطبيق لجداول البيانات.
</Accordion>
<Accordion title="هل يتم تضمين معرّفات العلاقات؟">
نعم، ولكن فقط على جانب "المتعدد" من العلاقات. على سبيل المثال، يتضمن تصدير الأشخاص `companyId`، بينما لا يتضمن تصدير الشركات معرّفات الأشخاص.
</Accordion>
<Accordion title="هل يمكنني أتمتة عمليات التصدير؟">
ليس مباشرة عبر واجهة المستخدم. استخدم واجهة برمجة التطبيقات (API) لبناء عمليات سير عمل تصدير مؤتمتة.
</Accordion>
</AccordionGroup>
## الخطوات التالية
* [كيفية تحديث السجلات الموجودة](/l/ar/user-guide/data-migration/how-tos/update-existing-records-via-import) — حرّر وأعد استيراد ملف التصدير الخاص بك
* [كيفية استيراد البيانات عبر واجهة برمجة التطبيقات (API)](/l/ar/user-guide/data-migration/how-tos/import-data-via-api) — لمجموعات البيانات الكبيرة
* [وثائق واجهة برمجة التطبيقات (API)](/l/ar/developers/extend/api) — أنشئ عمليات سير عمل تصدير مخصصة

View File

@@ -0,0 +1,430 @@
---
title: إصلاح أخطاء الاستيراد
description: دليل شامل لاستكشاف أخطاء استيراد CSV وإصلاحها.
---
## نظرة عامة
هل تواجه مشكلة في الاستيراد؟ يساعدك هذا الدليل على تحديد أخطاء الاستيراد الشائعة وإصلاحها خطوة بخطوة.
## كيف تعمل عملية التحقّق من الاستيراد
بعد رفع ملفك وتعيين الأعمدة، تتحقّق Twenty من بياناتك:
1. **تُجرى عملية التحقّق** — تتحقّق Twenty من كل صف بحثًا عن الأخطاء
2. **تمييز الأخطاء** — تظهر الصفوف ذات المشكلات باللون **الأصفر**
3. **يمكنك الإصلاح مباشرةً** — حرّر الخلايا مباشرةً في واجهة الاستيراد
4. **أو إزالة الصفوف** — تخطَّ السجلات التي بها مشكلات تمامًا
<Note>**أصلِح الأخطاء في الواجهة.** لست مضطرًا للعودة إلى جدول البيانات الخاص بك. حرّر الخلايا مباشرة أثناء الاستيراد لتوفير الوقت.</Note>
## استكشاف الأخطاء وإصلاحها خطوة بخطوة
### الخطوة 1: تحديد نوع الخطأ
انقر على صف مميّز للاطلاع على رسالة الخطأ المحددة. أنواع الأخطاء الشائعة:
| رسالة الخطأ | ماذا يعني ذلك |
| ----------------------------------------------------------------------- | ---------------------------------------------------- |
| تم تمييز القيم المكرّرة باللون الأصفر | القيمة موجودة مسبقًا في Twenty أو تظهر مرتين في ملفك |
| `{field} is not a valid {type}` (مرّر المؤشر فوق الخلية الصفراء) | البيانات لا تطابق التنسيق المتوقع |
| تم تمييز الحقل المطلوب | الحقل المطلوب فارغ |
| `Can't connect to {object}. No unique record found...` (يفشل الاستيراد) | السجل المشار إليه غير موجود |
| `Too many records. Up to 10000 allowed` (تم حظر التحميل) | يحتوي الملف على أكثر من 10,000 سجل |
### الخطوة 2: إصلاح الخطأ
اتّبع الإرشادات المحددة أدناه لكل نوع من الأخطاء.
---
## خطأ: قيمة مكرّرة
### ما ستراه
تُميَّز الصفوف ذات القيم المكرّرة باللون **الأصفر** في واجهة الاستيراد قبل بدء الاستيراد.
### ماذا يعني ذلك
حقل فريد (البريد الإلكتروني، النطاق) إمّا:
* موجود مسبقًا في Twenty
* يظهر مرتين في ملفك
### كيفية الإصلاح
**الخيار 1: تعديل القيمة المكرّرة**
1. انقر فوق الخلية التي تحتوي على الخطأ
2. غيّرها إلى قيمة فريدة
3. تابع الاستيراد
**الخيار 2: إزالة الصف المكرّر**
1. انقر الرمز X بجوار الصف
2. سيتم تخطّي الصف أثناء الاستيراد
**الخيار 3: دع Twenty تحدّث السجل الموجود**
1. تأكّد من أن ملفك يتضمن معرّفًا فريدًا (`email`، `domain`، أو `id`)
2. قم بتعيين حقل المعرّف الفريد
3. ستقوم Twenty بتحديث السجل الموجود بدلًا من إنشاء نسخة مكرّرة
<Note>
**يمكنك تحديث الحقول الفريدة أيضًا.**
* إذا أبقيت على `id` لكن غيّرت `email` → فسيتم تحديث البريد الإلكتروني
* إذا أبقيت على `email` لكن غيّرت `id` → فسيتم تحديث المعرّف
طالما أن أحد المعرّفات الفريدة يطابق، تقوم Twenty بتحديث السجل.
</Note>
### كيفية منع هذا الخطأ
قبل الاستيراد:
1. رتّب جدول البيانات حسب الحقل الفريد
2. أزل الصفوف المكرّرة
3. تحقّق مما إذا كانت السجلات موجودة مسبقًا في Twenty
<Warning>
**السجلات المحذوفة حذفًا ناعمًا تُحتسب ضمن التفرد.**
تحقّق من قائمة الأوامر → اعرض السجلات المحذوفة. السجلات هناك ما تزال تفرض شرط التفرد. احذفها نهائيًا أو استعدها وقم بتحديثها.
</Warning>
لمزيد من التفاصيل: [قيود التفرد](/l/ar/user-guide/data-migration/capabilities/uniqueness-constraints)
---
## خطأ: تنسيق غير صالح
### ما ستراه
تم تمييز قيمة الخلية باللون الأصفر. مرّر المؤشر فوقها للاطلاع على رسالة الخطأ:
```
{field name} is not a valid {field type}
```
### ماذا يعني ذلك
لا تطابق البيانات التنسيق المتوقع لذلك النوع من الحقول.
### كيفية الإصلاح — حسب نوع الحقل
#### البريد الإلكتروني
**المشكلة:** تنسيق بريد إلكتروني غير صالح
**الحل:** استخدم التنسيق `name@domain.com`
```
❌ john.smith@
❌ john smith@acme.com
✓ john.smith@acme.com
```
#### النطاق
**المشكلة:** قد يتسبب عدم اتساق التنسيق في حدوث تكرارات
**الحل:** استخدم تنسيق `https://domain.com` (موصى به)
```
⚠️ acme.com (valid, but not recommended)
⚠️ www.acme.com (valid, but not recommended)
✅ https://acme.com (recommended)
```
<Note>جميع التنسيقات صالحة، لكن يُوصى بـ `https://domain.com` لأنه يطابق التنسيق المستخدم في مزامنة البريد الإلكتروني/التقويم. قد يؤدي استخدام تنسيقات أخرى إلى إنشاء شركات مكرّرة.</Note>
#### تاريخ
**المشكلة:** تنسيق تاريخ غير معروف
**الحل:** استخدم تنسيق `YYYY-MM-DD` بشكل متّسق في جميع أنحاء الملف
```
✓ 2024-03-15 (YYYY-MM-DD)
❌ 03/15/2024 (MM/DD/YYYY)
❌ 15/03/2024 (DD/MM/YYYY)
```
#### هاتف
**المشكلة:** أعمدة مطلوبة مفقودة
**الحل:** تضمين جميع أعمدة الهاتف
| العمود | مثال |
| --------------------------------------- | ------------ |
| **Phones / Primary Phone Number** | `4159095555` |
| **Phones / Primary Phone Country Code** | `US` |
| **Phones / Primary Phone Calling Code** | `+1` |
#### قيمة منطقية
**المشكلة:** قيمة منطقية خاطئة
**الحل:** استخدم `TRUE` أو `FALSE` بحروف كبيرة
```
❌ true
❌ yes
❌ 1
✓ TRUE
✓ FALSE
```
#### اختيار / اختيار متعدد
**المشكلة:** لا تطابق القيمة الخيارات الموجودة
**الحل:** استخدم **أسماء واجهة برمجة التطبيقات (API)**، وليس تسميات العرض
كيفية العثور على أسماء واجهة برمجة التطبيقات:
1. اذهب إلى **الإعدادات → نموذج البيانات**
2. اختر الكائن والحقل
3. فعّل **الوضع المتقدم** (زر التبديل في أسفل اليمين)
4. استخدم اسم واجهة برمجة التطبيقات (على سبيل المثال، `OPTION_1`، وليس "Option 1")
```
❌ High Priority
✓ HIGH_PRIORITY
```
#### العملة
**المشكلة:** المبلغ أو رمز العملة مفقود
**الحل:** املأ كلا العمودين
| العمود | مثال |
| ------------------- | --------- |
| **المبلغ / المبلغ** | `1234.56` |
| **المبلغ / العملة** | `USD` |
#### رقم
**المشكلة:** أحرف غير رقمية
**الحل:** أرقام فقط، ونقطة للفواصل العشرية
```
❌ $1,234.56
❌ 1,234.56
✓ 1234.56
```
للاطلاع على مرجع التنسيقات الكامل: [مرجع تعيين الحقول](/l/ar/user-guide/data-migration/capabilities/field-mapping)
---
## خطأ: حقل مطلوب مفقود
### ما ستراه
تم تمييز الصف باللون الأصفر مع وضع علامة على خلية الحقل المطلوب.
### ماذا يعني ذلك
الحقل المطلوب فارغ لهذا الصف.
### كيفية الإصلاح
**الخيار 1: إدخال قيمة**
1. انقر فوق الخلية الفارغة
2. أدخل قيمة
3. تابع الاستيراد
**الخيار 2: إزالة الصف**
1. إذا لم تكن لديك البيانات، انقر X لتخطّي الصف
### كيفية منع هذا الخطأ
قبل الاستيراد، حدّد الحقول المطلوبة:
1. اذهب إلى **الإعدادات → نموذج البيانات**
2. اختر الكائن الخاص بك
3. تحقّق من الحقول المُعلمة كمطلوبة
---
## خطأ: العلاقة غير موجودة
### ما ستراه
يظهر هذا الخطأ **بعد بدء الاستيراد** — يفشل الاستيراد برسالة مثل:
```
Can't connect to company. No unique record found with condition: id = 7776ee49-f608-4a77-8cc8-6fe96ae1e43f
```
هذا يعني أنه لا توجد شركة في Twenty بذلك المعرّف المحدّد.
<Note>على عكس الأخطاء الأخرى، لا يُلتقط هذا الخطأ أثناء خطوة مراجعة البيانات. سيبدأ الاستيراد ثم يفشل عند مواجهة العلاقة المفقودة.</Note>
### ماذا يعني ذلك
تحاول ربط سجل غير موجود في Twenty.
### كيفية الإصلاح
**الخيار 1: استيراد سجلات الأصل أولًا**
1. ألغِ الاستيراد الحالي
2. استورد سجلات الأصل (مثلًا، الشركات)
3. ثم استورد سجلات التابع (مثلًا، الأشخاص)
**الخيار 2: أصلِح قيمة المرجع**
1. تحقّق من قيمة المرجع في ملفك
2. تأكّد من أنه يطابق سجلًا موجودًا تمامًا
3. تحقّق من التنسيق: يجب أن تكون النطاقات بصيغة `https://domain.com`
**الخيار 3: إزالة العلاقة**
1. امسح الخلية للاستيراد دون العلاقة
2. أضِف العلاقة يدويًا لاحقًا
### كيفية منع هذا الخطأ
1. **استورد بالترتيب الصحيح:**
* الشركات أولًا
* الأشخاص ثانيًا (مع مراجع الشركة)
* الفرص ثالثًا
2. **تحقّق من قيم المراجع:**
* صدّر سجلات الأصل للحصول على معرّفات دقيقة
* استخدم تنسيق النطاق `https://domain.com`
* تحقّق من الأخطاء الإملائية وحساسية حالة الأحرف
<Warning>
**سيفشل الاستيراد إذا تمت الإشارة إلى سجل غير موجود.**
استورد دائمًا كائنات الأصل قبل كائنات التابع.
</Warning>
لمزيد من التفاصيل: [استيراد العلاقات](/l/ar/user-guide/data-migration/capabilities/import-relations)
---
## خطأ: ملف كبير جدًا
### ما ستراه
يظهر هذا الخطأ **عند رفع ملفك** — يتم حظر التحميل بالكامل:
```
Too many records. Up to 10000 allowed
```
لن تتمكّن من الانتقال إلى خطوة مراجعة البيانات حتى تقلّل حجم الملف.
### ماذا يعني ذلك
يحتوي ملفك على أكثر من 10,000 سجل.
### كيفية الإصلاح
**الخيار 1: التقسيم إلى عدة ملفات**
1. قسّم بياناتك إلى ملفات تحتوي على 10,000 سجل أو أقل
2. استورد كل ملف على حدة
3. حافظ على ترتيب الاستيراد (الشركات قبل الأشخاص)
**الخيار 2: استخدم الاستيراد عبر واجهة برمجة التطبيقات (API)**
بالنسبة لمجموعات البيانات الكبيرة جدًا، استخدم واجهة برمجة التطبيقات التي لا تحتوي على حد لعدد السجلات.
راجع: [كيفية استيراد البيانات عبر واجهة برمجة التطبيقات (API)](/l/ar/user-guide/data-migration/how-tos/import-data-via-api)
---
## خطأ: لم يتم التعرّف على الحقل
### ماذا يعني ذلك
لا يمكن تعيين عمود في ملفك لأن الحقل غير موجود في Twenty.
### كيفية الإصلاح
1. اذهب إلى **الإعدادات → نموذج البيانات**
2. اختر الكائن الذي تستورده
3. انقر **+ إضافة حقل**
4. أنشئ الحقل المخصّص بالنوع المناسب
5. أعد رفع ملفك
<Note>يُنشئ استيراد CSV سجلات، وليس حقولًا. يجب أن تكون جميع الحقول موجودة قبل الاستيراد.</Note>
---
## خطأ: علاقة المستخدم فارغة
### ماذا يعني ذلك
تحاول إسناد سجل إلى مستخدم (المالك، المعيَّن) لكن العلاقة لا يتم تعيينها.
### أسباب شائعة
1. **لم يقبل المستخدم دعوته** — المستخدم غير موجود في Twenty بعد
2. **استخدام معرّف مستخدم من نظام قديم** — لا تستطيع Twenty مطابقة المعرّفات من نظام آخر
3. **تنسيق بريد إلكتروني خاطئ** — البريد الإلكتروني لا يطابق حساب المستخدم في Twenty
### كيفية الإصلاح
1. تأكّد من أن جميع المستخدمين قد **قبلوا دعوتهم** إلى مساحة عمل Twenty الخاصة بك
2. استخدم **عنوان البريد الإلكتروني** الخاص بالمستخدم (وليس اسمه أو معرّف النظام القديم)
3. استخدم البريد الإلكتروني نفسه الذي استخدموه للانضمام إلى Twenty
<Warning>
**يجب على المستخدمين قبول الدعوات قبل الاستيراد.**
إذا لم يقبل المستخدم دعوته، فستكون علاقات المستخدم فارغة في السجلات التي تشير إليه.
</Warning>
---
## قائمة ما قبل الاستيراد
تجنّب الأخطاء من خلال التحقّق مما يلي قبل الاستيراد:
### متطلبات الملف
<Check>الملف بتنسيق CSV أو XLSX أو XLS</Check>
<Check>يحتوي الملف على أقل من 10,000 سجل</Check>
<Check>يستخدم الملف ترميز UTF-8</Check>
### جودة البيانات
<Check>لا توجد رسائل بريد إلكتروني مكرّرة (للأشخاص)</Check>
<Check>لا توجد نطاقات مكرّرة (للشركات)</Check>
<Check>جميع التواريخ تستخدم تنسيقًا متّسقًا</Check>
<Check>جميع النطاقات تستخدم تنسيق `https://domain.com`</Check>
### تنسيقات الحقول
<Check>الحقول المنطقية تستخدم `TRUE` أو `FALSE` (أحرف كبيرة)</Check>
<Check>حقول الاختيار تستخدم أسماء واجهة برمجة التطبيقات (API)، وليس تسميات العرض</Check>
<Check>حقول الهاتف تحتوي على جميع الأعمدة المطلوبة</Check>
<Check>حقول العملة تتضمن كلًا من المبلغ ورمز العملة</Check>
### العلاقات
<Check>تم استيراد سجلات الأصل قبل سجلات التابع</Check>
<Check>أعمدة العلاقات تشير إلى سجلات موجودة</Check>
<Check>تنسيق النطاق يطابق تنسيق Twenty تمامًا</Check>
### نموذج البيانات
<Check>جميع الحقول المخصّصة موجودة في الإعدادات → نموذج البيانات</Check>
<Check>خيارات الاختيار موجودة قبل الاستيراد</Check>
---
## هل لا تزال تواجه مشكلات؟
إذا كنت قد جرّبت الحلول أعلاه:
1. **نزّل ملف العيّنة** — اطّلع على التنسيق الدقيق الذي تتوقعه Twenty
2. **صدّر السجلات الموجودة** — قارن ملفك بالبيانات التي تعمل بشكل صحيح
3. **اختبر بدفعة صغيرة** — جرّب 5-10 صفوف أولًا
4. **اطّلع على مقالات المرجع:**
* [مرجع تعيين الحقول](/l/ar/user-guide/data-migration/capabilities/field-mapping)
* [قيود التفرد](/l/ar/user-guide/data-migration/capabilities/uniqueness-constraints)
* [كيفية استيراد العلاقات](/l/ar/user-guide/data-migration/capabilities/import-relations)
* [التعامل مع الأخطاء](/l/ar/user-guide/data-migration/capabilities/error-handling)

View File

@@ -0,0 +1,201 @@
---
title: استيراد الشركات عبر CSV
description: دليل كامل خطوة بخطوة لاستيراد الشركات إلى Twenty.
---
## نظرة عامة
يرشدك هذا الدليل خلال عملية استيراد شركاتك إلى Twenty. **يجب استيراد الشركات أولًا** لأن الأشخاص والفرص ترتبط بالشركات.
## قبل أن تبدأ
### قائمة المتطلبات المسبقة
<Check>
يجب أن يكون ملفك بتنسيق CSV أو XLSX أو XLS
</Check>
<Check>
يحتوي الملف على أقل من 10,000 سجل
</Check>
<Check>
لا توجد نطاقات مكررة في ملفك
</Check>
<Check>
جميع الحقول المخصصة موجودة في **Settings → Data Model**
</Check>
<Note>
هل تحتاج إلى استيراد أكثر من 10,000 شركة؟ قسّم إلى ملفات متعددة أو استخدم [استيراد عبر API](/l/ar/user-guide/data-migration/how-tos/import-data-via-api).
</Note>
## الخطوة 1: جهّز بيانات شركتك
### الحقول المطلوبة والمُوصى بها
| الحقل | هل هو مطلوب؟ | التنسيق | الملاحظات |
| ------------------ | ------------ | -------------------- | -------------------------------- |
| **Name** | مُوصى به | نص | اسم العرض للشركة |
| **النطاق** | مُوصى به | `https://domain.com` | معرّف فريد |
| **العنوان** | اختياري | أعمدة متعددة | انظر أدناه |
| **الموظفون** | اختياري | رقم | عدد الموظفين |
| **الحقول المخصصة** | اختياري | يختلف | يجب أن تكون موجودة في Data Model |
### تنسيق النطاق
<Warning>
**استخدم التنسيق `https://domain.com` للنطاقات.**
هذا يطابق التنسيق المستخدم عند إنشاء الشركات تلقائيًا من مزامنة البريد الإلكتروني/التقويم، مما يمنع التكرارات لاحقًا.
</Warning>
**أعمدة النطاق:**
* **Domain / Domain Label**: `acme.com`
* **Domain / Domain URL**: `https://acme.com`
### تنسيق العنوان
العنوان حقل متداخل يتضمن أعمدة متعددة:
```
Address / Address 1,Address / City,Address / State,Address / Country,Address / Post Code
123 Main Street,San Francisco,CA,USA,94105
```
### بنية CSV نموذجية
```csv
name,Domain / Domain URL,Domain / Domain Label,Address / City,Address / Country,employees
Acme Corp,https://acme.com,acme.com,San Francisco,USA,250
Widget Co,https://widgets.co,widgets.co,New York,USA,50
```
<Note>
**نصيحة احترافية:** انقر **Download sample file** أثناء الاستيراد للاطلاع على أسماء الأعمدة الدقيقة التي تتوقعها Twenty.
</Note>
## الخطوة 2: الوصول إلى ميزة الاستيراد
**الخيار 1: من عرض الشركات**
1. انتقل إلى **Companies** في الشريط الجانبي الأيسر
2. انقر على أيقونة **⋮** في أعلى اليمين
3. اختر **Import records**
**الخيار 2: باستخدام قائمة الأوامر**
1. اضغط `Cmd + K` (Mac) أو `Ctrl + K` (Windows)
2. اكتب "import"
3. اختر **Import records**
4. اختر **Companies**
## الخطوة 3: حمّل ملفك
1. انقر فوق **Select file**
2. اختر ملف CSV أو XLSX أو XLS الخاص بك
3. انتظر حتى تقوم Twenty بتحليل ملفك
## الخطوة 4: طابق أعمدتك
يحاول Twenty تلقائيًا مطابقة أعمدتك مع الحقول. راجع وعدّل:
1. **تحقق من المطابقات التلقائية** — تأكد من أنها صحيحة
2. **أصلح المطابقات غير الصحيحة** — انقر على القائمة المنسدلة لاختيار الحقل الصحيح
3. **تخطَّ الأعمدة** — اختر **Do not map** للأعمدة التي لا تريد استيرادها
### قواعد مطابقة مهمة
* **النطاق**: طابق مع **Domain / Domain URL** (وليس Domain Label)
* **العنوان**: طابق كل جزء مع العمود المحدد له (المدينة، الولاية، إلخ.)
* **حقول الاختيار**: يجب أن تطابق القيم الخيارات الموجودة (أو ستقوم بمطابقتها في الخطوة التالية)
<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}} />
## الخطوة 5: تعيين قيم حقل الاختيار
إذا كانت لديك حقول اختيار أو اختيار متعدد:
1. تعرض Twenty قيمك إلى جانب الخيارات الموجودة
2. طابِق كل قيمة في ملفك مع خيار في Twenty
3. أو أنشئ خيارات جديدة عند الحاجة
<Note>
تستخدم خيارات الاختيار **أسماء API**، وليس تسميات العرض. تحقّق من **Settings → Data Model** → فعِّل **Advanced mode** لمشاهدة أسماء API.
</Note>
## الخطوة 6: مراجعة الأخطاء وإصلاحها
قبل إكمال الاستيراد، تقوم Twenty بالتحقق من صحة بياناتك:
1. انقر على **الخطوات التالية**
2. يتم تمييز الصفوف التي تحتوي على أخطاء باللون **الأصفر**
3. **أصلِح الأخطاء مباشرةً** — انقر على خلية وعدّل القيمة
4. **أزِل الصفوف التي بها مشكلات** — انقر على X لتخطي ذلك الصف
### أخطاء شائعة عند استيراد الشركات
| خطأ | السبب | الحل |
| ----------------------- | ----------------------------- | ------------------------------------ |
| **نطاق مكرر** | النطاق موجود مسبقًا في Twenty | أزِل من الملف أو حدِّث السجل الموجود |
| **تنسيق نطاق غير صالح** | تنسيق غير صحيح | استخدم `https://domain.com` |
| **حقل مطلوب مفقود** | الحقل المطلوب فارغ | املأ القيمة أو أزِل الصف |
## الخطوة 7: إكمال الاستيراد
1. راجِع ملخص الاستيراد
2. انقر على **تأكيد** للاستيراد
3. انتظر حتى يكتمل الاستيراد
4. تحقق بمراجعة عدد قليل من السجلات
## بعد استيراد الشركات
يمكنك الآن استيراد السجلات التي ترتبط بالشركات:
1. **[استيراد الأشخاص](/l/ar/user-guide/data-migration/how-tos/import-contacts-via-csv)** — اربطهم بالشركات باستخدام النطاق
2. **استورد الفرص** — اربطها بالشركات
3. **تحقق من الاستيراد** — افحص عينة من السجلات للتأكد من أن البيانات صحيحة
## تحديث الشركات الموجودة
لتحديث الشركات بدلًا من إنشاء شركات جديدة:
1. ضمّن عمود `domain` أو `id` في ملفك
2. تقوم Twenty بمطابقة السجلات باستخدام هذا المعرّف الفريد
3. يتم تحديث الشركات الموجودة؛ ويتم إنشاء شركات جديدة
راجع [كيفية تحديث السجلات الموجودة](/l/ar/user-guide/data-migration/how-tos/update-existing-records-via-import) للتفاصيل.
## الأسئلة الشائعة
<AccordionGroup>
<Accordion title="لماذا لا يمكن لشركتين أن تمتلكا النطاق نفسه؟">
النطاق معرّف فريد في Twenty. هذا يمنع تكرار الشركات ويضمن أن مزامنة البريد الإلكتروني تربط الرسائل بالشركة الصحيحة على نحو صحيح.
</Accordion>
<Accordion title="ماذا لو كانت لديّ شركات بلا نطاق؟">
يمكنك ترك النطاق فارغًا. ومع ذلك، نوصي بإضافة النطاقات عندما يكون ذلك ممكنًا لتحسين جودة البيانات والربط التلقائي للبريد الإلكتروني.
</Accordion>
<Accordion title="هل يمكنني استيراد شركات دون ربط أي أشخاص بها؟">
نعم! يمكنك استيراد الشركات أولاً، ثم استيراد الأشخاص لاحقًا وربطهم باستخدام نطاق الشركة.
</Accordion>
<Accordion title="ماذا يحدث إذا قمتُ باستيراد نطاق موجود بالفعل؟">
إذا تضمّنت معرّفًا فريدًا (نطاقًا أو id) يطابق شركةً موجودة، يقوم Twenty بتحديث تلك الشركة بدلاً من إنشاء نسخة مكررة.
</Accordion>
<Accordion title="كيف أصلِح أخطاء 'نطاق مكرر'؟">
إمّا أن تزيل النسخة المكررة من ملفك، أو تُدرج `id` الخاصة بالشركة لتحديث السجل الموجود بدلًا من ذلك.
</Accordion>
</AccordionGroup>
## استكشاف الأخطاء وإصلاحها
هل تواجه مشكلات؟ اطّلع على:
* [كيفية إصلاح أخطاء الاستيراد](/l/ar/user-guide/data-migration/how-tos/fix-import-errors)
* [مرجع تعيين الحقول](/l/ar/user-guide/data-migration/capabilities/field-mapping)
* [قيود التفرد](/l/ar/user-guide/data-migration/capabilities/uniqueness-constraints)

View File

@@ -0,0 +1,242 @@
---
title: استيراد جهات الاتصال عبر CSV
description: دليل كامل خطوة بخطوة لاستيراد الأشخاص/جهات الاتصال إلى Twenty.
---
## نظرة عامة
يرشدك هذا الدليل خلال عملية استيراد جهات الاتصال (الأشخاص) إلى Twenty.
## قبل أن تبدأ
### قائمة المتطلبات المسبقة
<Check>
يجب أن يكون ملفك بتنسيق CSV أو XLSX أو XLS
</Check>
<Check>
يحتوي الملف على أقل من 10,000 سجل
</Check>
<Check>
لا توجد عناوين بريد إلكتروني مكررة في ملفك
</Check>
<Check>
**استيراد الشركات أولًا** (إذا كنت تربط الأشخاص بالشركات)
</Check>
<Check>
جميع الحقول المخصصة موجودة في **Settings → Data Model**
</Check>
<Warning>
**استيراد الشركات قبل الأشخاص**
إذا كنت تريد ربط الأشخاص بالشركات، فاستورد الشركات أولًا. يجب أن تكون الشركة موجودة قبل أن تتمكن من الإشارة إليها.
</Warning>
## الخطوة 1: جهّز بيانات جهات الاتصال الخاصة بك
### الحقول المطلوبة والمُوصى بها
| الحقل | هل هو مطلوب؟ | التنسيق | الملاحظات |
| --------------------- | ------------ | ----------------- | -------------------------------- |
| **البريد الإلكتروني** | مُوصى به | `name@domain.com` | يجب أن يكون فريدًا |
| **الاسم الأول** | مُوصى به | نص | |
| **الاسم الأخير** | مُوصى به | نص | |
| **الشركة** | اختياري | النطاق أو المعرّف | يرتبط بشركة موجودة |
| **هاتف** | اختياري | أعمدة متعددة | انظر أدناه |
| **المسمى الوظيفي** | اختياري | نص | |
| **الحقول المخصصة** | اختياري | يختلف | يجب أن تكون موجودة في Data Model |
### تنسيق البريد الإلكتروني
* يجب أن يكون بتنسيق بريد إلكتروني صالح: `name@domain.com`
* **يجب أن يكون فريدًا** — لا تكرارات في ملفك أو في Twenty
* للعناوين الإضافية للبريد الإلكتروني، استخدم عمود **Emails / Additional Emails**:
```
["jane@twenty.com","jane.doe@twenty.com"]
```
### تنسيق الهاتف
الهاتف هو **حقل متداخل** يتطلب أعمدة متعددة:
| العمود | مثال |
| --------------------------------------- | ------------ |
| **Phones / Primary Phone Number** | `4159095555` |
| **Phones / Primary Phone Country Code** | `US` |
| **Phones / Primary Phone Calling Code** | `+1` |
### الربط بالشركات
أضف عمودًا يضم المعرّف الفريد للشركة:
| اسم العمود | التنسيق | مثال |
| --------------- | --------------- | -------------------------------------- |
| `companyDomain` | تنسيق عنوان URL | `https://acme.com` |
| `companyId` | UUID | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
<Note>
**استخدم تنسيق عنوان URL للنطاق** (`https://acme.com`)، وليس التسمية. هذا يطابق كيفية تخزين الشركات في Twenty.
</Note>
### بنية CSV نموذجية
```csv
firstName,lastName,email,jobTitle,companyDomain,Phones / Primary Phone Number,Phones / Primary Phone Country Code
John,Smith,john@acme.com,CEO,https://acme.com,4159095555,US
Jane,Doe,jane@widgets.co,CTO,https://widgets.co,2125551234,US
```
<Note>
**نصيحة احترافية:** انقر **Download sample file** أثناء الاستيراد أو صدّر عددًا قليلًا من الأشخاص الموجودين للاطلاع على أسماء الأعمدة الدقيقة التي تتوقعها Twenty.
</Note>
## الخطوة 2: الوصول إلى ميزة الاستيراد
**الخيار 1: من عرض People**
1. انتقل إلى **People** في الشريط الجانبي الأيسر
2. انقر على أيقونة **⋮** في أعلى اليمين
3. اختر **Import records**
**الخيار 2: باستخدام قائمة الأوامر**
1. اضغط `Cmd + K` (Mac) أو `Ctrl + K` (Windows)
2. اكتب "import"
3. اختر **Import records**
4. اختر **People**
## الخطوة 3: حمّل ملفك
1. انقر فوق **Select file**
2. اختر ملف CSV أو XLSX أو XLS الخاص بك
3. انتظر حتى يقوم Twenty بتحليل ملفك
## الخطوة 4: طابق أعمدتك
يحاول Twenty تلقائيًا مطابقة أعمدتك مع الحقول. راجع وعدّل:
1. **تحقق من المطابقات التلقائية** — تأكد من أنها صحيحة
2. **أصلح المطابقات غير الصحيحة** — انقر على القائمة المنسدلة لاختيار الحقل الصحيح
3. **تخطَّ الأعمدة** — اختر **Do not map** للأعمدة التي لا تريد استيرادها
### قواعد مطابقة مهمة
| نوع العمود | التعيين إلى | الملاحظات |
| --------------------------- | ------------------------------ | ------------------------------------- |
| مرجع الشركة | حقل علاقة **Company** | استخدم النطاق أو المعرّف، وليس كليهما |
| البريد الإلكتروني | **البريد الإلكتروني** | عنوان البريد الإلكتروني الأساسي |
| عناوين بريد إلكتروني إضافية | **Emails / Additional Emails** | تنسيق المصفوفة |
| هاتف | أعمدة منفصلة | الرقم، رمز الدولة، رمز الاتصال |
<img src="/images/user-guide/import-export-data/match-columns.png" style={{width:'100%'}} />
### مطابقة علاقة الشركة
عند مطابقة عمود الشركة:
1. اعثر على عمود مرجع الشركة (مثلًا، `companyDomain`)
2. طابقه مع حقل علاقة **Company**
3. سيقوم Twenty بربط كل شخص بالشركة المطابقة
<Warning>
**طابق معرّفًا فريدًا واحدًا فقط للعلاقات.**
لا تقم بتعيين كلٍّ من `companyId` و`companyDomain` معًا. اختر واحدًا — ويفضَّل استخدام النطاق لأنه مقروء للبشر.
</Warning>
## الخطوة 5: تعيين قيم حقل الاختيار
إذا كانت لديك حقول اختيار أو اختيار متعدد (مثل مصدر العميل المحتمل):
1. تعرض Twenty قيمك إلى جانب الخيارات الموجودة
2. طابِق كل قيمة في ملفك مع خيار في Twenty
3. أو أنشئ خيارات جديدة عند الحاجة
<Note>
تستخدم خيارات الاختيار **أسماء API**، وليس تسميات العرض. تحقّق من **الإعدادات → نموذج البيانات** → فعِّل **الوضع المتقدم** لمشاهدة أسماء API.
</Note>
## الخطوة 6: مراجعة الأخطاء وإصلاحها
قبل إكمال الاستيراد، تقوم Twenty بالتحقق من صحة بياناتك:
1. انقر على **الخطوات التالية**
2. يتم تمييز الصفوف التي تحتوي على أخطاء باللون **الأصفر**
3. **أصلِح الأخطاء مباشرةً** — انقر على خلية وعدّل القيمة
4. **أزِل الصفوف التي بها مشكلات** — انقر على X لتخطي ذلك الصف
### أخطاء شائعة عند استيراد جهات الاتصال
| خطأ | السبب | الحل |
| -------------------------------- | ---------------------------------------------------- | ------------------------------------ |
| **بريد إلكتروني مكرر** | البريد الإلكتروني موجود مسبقًا في Twenty أو في الملف | أزِل التكرار أو حدِّث السجل الموجود |
| **تنسيق بريد إلكتروني غير صالح** | تنسيق البريد الإلكتروني غير صحيح | صحّحه إلى `name@domain.com` |
| **العلاقة غير موجودة** | الشركة غير موجودة | استورد الشركات أولًا أو أصلِح المرجع |
| **حقل مطلوب مفقود** | الحقل المطلوب فارغ | املأ القيمة أو أزِل الصف |
## الخطوة 7: إكمال الاستيراد
1. راجِع ملخص الاستيراد
2. انقر على **تأكيد** للاستيراد
3. انتظر حتى يكتمل الاستيراد
4. تحقَّق بفحص عدد قليل من السجلات وروابطها بالشركة
## بعد استيراد جهات الاتصال
جهات الاتصال الخاصة بك موجودة الآن في Twenty! الخطوات التالية:
1. **تحقَّق من روابط الشركة** — افتح عددًا قليلًا من سجلات الأشخاص للتأكد من أنها مرتبطة بالشركة الصحيحة
2. **استورد الفرص** — واربطها عند الحاجة بالأشخاص والشركات
3. **اضبط مزامنة البريد الإلكتروني** — وصّل صندوق بريدك لعرض سجل البريد الإلكتروني في سجلات جهات الاتصال
## تحديث جهات الاتصال الموجودة
لتحديث جهات الاتصال بدلًا من إنشاء جهات جديدة:
1. ضمّن عمود `email` أو `id` في ملفك
2. تقوم Twenty بمطابقة السجلات باستخدام هذا المعرّف الفريد
3. يتم تحديث جهات الاتصال الموجودة؛ ويتم إنشاء جهات جديدة
راجع [كيفية تحديث السجلات الموجودة](/l/ar/user-guide/data-migration/how-tos/update-existing-records-via-import) للتفاصيل.
## الأسئلة الشائعة
<AccordionGroup>
<Accordion title="لماذا لا يمكن لشخصين أن يمتلكا البريد الإلكتروني نفسه؟">
البريد الإلكتروني معرّف فريد في Twenty. هذا يمنع تكرار جهات الاتصال ويضمن أن مزامنة البريد الإلكتروني تربط الرسائل بالشخص الصحيح على نحوٍ صحيح.
</Accordion>
<Accordion title="ماذا لو كان لديّ أشخاص بلا بريد إلكتروني؟">
يمكنك ترك البريد الإلكتروني فارغًا. مع ذلك، نوصي بإضافة عناوين البريد الإلكتروني عندما يكون ذلك ممكنًا لتحسين جودة البيانات ووظائف مزامنة البريد الإلكتروني.
</Accordion>
<Accordion title="كيف أربط الأشخاص بالشركات أثناء الاستيراد؟">
أضِف عمودًا يحتوي على نطاق الشركة (مثلًا، `https://acme.com`) أو المعرّف. أثناء عملية التعيين، اربط هذا العمود بحقل علاقة الشركة.
</Accordion>
<Accordion title="ماذا لو لم تكن الشركة موجودة بعد؟">
استورد الشركات أولًا، ثم استورد الأشخاص. يجب أن تكون الشركة موجودة قبل أن تتمكّن من الإشارة إليها.
</Accordion>
<Accordion title="هل يمكنني استيراد المعرّف من نظام إدارة علاقات العملاء (CRM) السابق لديّ؟">
نعم! أنشئ حقلًا مخصصًا موسومًا بأنه "unique" في نموذج بياناتك لتخزين المعرّف الخارجي. ملاحظة: اسم الحقل `id` محجوز للمعرّف الداخلي الخاص بـ Twenty.
</Accordion>
<Accordion title="كيف أصلِح أخطاء 'العلاقة غير موجودة'؟">
الشركة التي تشير إليها غير موجودة. إما أن تستورد الشركة أولًا، أو تأكّد من أن النطاق/المعرّف يطابق تمامًا شركةً موجودة.
</Accordion>
</AccordionGroup>
## استكشاف الأخطاء وإصلاحها
هل تواجه مشكلات؟ اطّلع على:
* [كيفية إصلاح أخطاء الاستيراد](/l/ar/user-guide/data-migration/how-tos/fix-import-errors)
* [كيفية استيراد العلاقات](/l/ar/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
* [مرجع تعيين الحقول](/l/ar/user-guide/data-migration/capabilities/field-mapping)

View File

@@ -0,0 +1,176 @@
---
title: استيراد البيانات عبر واجهة API
description: متى وكيف تستخدم واجهات API الخاصة بـ Twenty لاستيراد البيانات على نطاق واسع.
---
## نظرة عامة
توفّر Twenty كلًا من **GraphQL** و**واجهات REST API** لاستيراد البيانات برمجيًا. استخدم واجهة API عندما لا يكون استيراد CSV عمليًا لحجم بياناتك أو عندما تحتاج إلى عمليات استيراد مؤتمتة ومتكررة.
## متى تستخدم الاستيراد عبر API
| السيناريو | الطريقة الموصى بها |
| ----------------------------- | ---------------------------- |
| أقل من 10,000 سجل | استيراد CSV |
| 10,000 - 50,000 سجل | استيراد CSV (قسّم إلى ملفات) |
| **أكثر من 50,000 سجل** | **استيراد API** |
| ترحيل لمرة واحدة | أيّ منهما (حسب الحجم) |
| **عمليات استيراد متكررة** | **استيراد API** |
| **مزامنة في الوقت الحقيقي** | **استيراد API** |
| **التكامل مع الأنظمة الأخرى** | **استيراد API** |
<Note>بالنسبة لمجموعات البيانات التي تبلغ مئات الآلاف، تكون واجهة API أسرع بكثير وأكثر موثوقية من عمليات استيراد CSV المتعددة.</Note>
## حدود معدل API
تفرض Twenty حدودًا للمعدل لضمان استقرار النظام:
| الحد | القيمة |
| ---------------------------- | ---------------- |
| **الطلبات في الدقيقة** | 100 |
| **السجلات لكل استدعاء دفعي** | 60 |
| **الحد الأقصى للإنتاجية** | ~6,000 سجل/دقيقة |
<Warning>
**خطّط لعملية الاستيراد وفق هذه الحدود.**
بالنسبة إلى 100,000 سجل عند أقصى إنتاجية، توقّع نحو 17 دقيقة من وقت الاستيراد. أضِف وقتًا احتياطيًا لمعالجة الأخطاء وإعادة المحاولة.
</Warning>
## البدء
### الخطوة 1: احصل على مفتاح API الخاص بك
1. انتقل إلى **الإعدادات → المطوّرون**
2. انقر **+ إنشاء مفتاح API**
3. امنح مفتاحك اسمًا وصفيًا
4. انسخ مفتاح API فورًا (لن يُعرَض مرة أخرى)
5. احفظه في مكان آمن
<Warning>
**أبقِ مفتاح API سريًا.**
يمكن لأي شخص لديه مفتاح API الخاص بك الوصول إلى بيانات مساحة العمل الخاصة بك وتعديلها. لا تقم أبدًا بإيداعه في مستودعات الكود أو مشاركته علنًا.
</Warning>
### الخطوة 2: اختر واجهة API الخاصة بك
تدعم Twenty نوعين من واجهات API:
| واجهة برمجة التطبيقات | الأفضل لـ | التوثيق |
| --------------------- | ------------------------------------------------------ | ----------------------------------- |
| **GraphQL** | استعلامات مرنة، وجلب البيانات المرتبطة، وعمليات معقّدة | [وثائق API](/l/ar/developers/extend/api) |
| **REST** | عمليات CRUD بسيطة، وأنماط REST مألوفة | [وثائق API](/l/ar/developers/extend/api) |
كلتا واجهتي API تدعمان:
* إنشاء السجلات وقراءتها وتحديثها وحذفها
* **عمليات الدُفعات** — إنشاء أو تحديث ما يصل إلى 60 سجلًا لكل استدعاء
**لعمليات الاستيراد، استخدم عمليات الدُفعات** لتعظيم الإنتاجية ضمن حدود المعدل.
### الخطوة 3: خطّط لترتيب الاستيراد
تمامًا مثل عمليات استيراد CSV، فإن **الترتيب مهم** للعلاقات:
1. **الشركات** أولًا (من دون تبعيات)
2. **الأشخاص** ثانيًا (يمكن ربطهم بالشركات)
3. **الفرص** ثالثًا (يمكن ربطها بالشركات والأشخاص)
4. **المهام/الملاحظات** (يمكن ربطها بأي مما سبق)
5. **الكائنات المخصّصة** (وفقًا لتبعياتها)
## أفضل الممارسات
### اجمع طلباتك في دُفعات
* لا ترسل السجلات واحدًا تلو الآخر
* اجمع ما يصل إلى **60 سجلًا لكل استدعاء API**
* هذا يُعظّم الإنتاجية ضمن حدود المعدل
### التعامل مع حدود المعدل
* طبّق فواصل زمنية بين الطلبات (600 مللي ثانية كحد أدنى لعمليات الاستيراد المستمرة)
* استخدم التراجع الأسي عند بلوغ الحدود
* راقِب الاستجابات 429 (طلبات كثيرة جدًا)
### تحقّق من البيانات أولًا
* نظّف بياناتك وتحقّق منها قبل الاستيراد
* تحقّق من تعبئة الحقول المطلوبة
* تحقّق من توافق التنسيقات مع متطلبات Twenty (راجع [تعيين الحقول](/l/ar/user-guide/data-migration/capabilities/field-mapping))
### سجّل كل شيء
* سجّل كل سجل تم استيراده (بما في ذلك المعرّفات)
* سجّل الأخطاء مع السياق الكامل
* يساعد ذلك في تصحيح المشكلات والتحقق من الإكمال
### اختبر أولًا
* اختبر بدفعة صغيرة (10-20 سجلًا)
* تحقّق من ظهور البيانات بشكل صحيح في Twenty
* ثم نفّذ عملية الاستيراد الكاملة
### استخدم upsert لتجنّب التكرارات
واجهة GraphQL API تدعم **upsert على دفعات** — حدِّث إذا كان السجل موجودًا، وأنشئ إذا لم يكن كذلك. يمنع هذا التكرارات عند إعادة تشغيل عمليات الاستيراد.
## العثور على أسماء الكائنات والحقول
للاطلاع على الكائنات والحقول المتاحة:
1. انتقل إلى **الإعدادات → API وخطافات الويب**
2. استعرض **واجهة API للبيانات الوصفية**
3. اعرض جميع الكائنات القياسية والمخصّصة مع حقولها
تُظهر الوثائق جميع الكائنات القياسية والمخصّصة وحقولها وأنواع البيانات المتوقعة.
## الخدمات الاحترافية
بالنسبة لعمليات ترحيل API المعقّدة، يمكن لشركائنا تقديم المساعدة:
| الخدمة | ما الذي يتضمّنه |
| ------------------------ | ------------------------------------- |
| **تصميم نموذج البيانات** | تصميم الهيكل الأمثل لبياناتك |
| **برامج نصية للترحيل** | كتابة وتشغيل البرامج النصية للاستيراد |
| **تحويل البيانات** | التعامل مع التعيين المعقّد والتنظيف |
| **التحقق وضمان الجودة** | التحقق من اكتمال عملية الترحيل |
**الأفضل لـ:**
* عمليات ترحيل لأكثر من 100,000 سجل
* تحويلات بيانات معقّدة
* جداول زمنية ضيّقة
* الفرق التي تفتقر إلى موارد المطورين
تواصل معنا عبر [contact@twenty.com](mailto:contact@twenty.com) أو استكشف [خدمات التنفيذ](/l/ar/user-guide/getting-started/capabilities/implementation-services).
## الأسئلة الشائعة
<AccordionGroup>
<Accordion title="ما الفرق بين GraphQL وREST؟">
يتيح لك GraphQL طلب البيانات التي تحتاجها بدقة ضمن استعلام واحد، وهو أفضل للعمليات المعقّدة. يعتمد REST على طرق HTTP القياسية (GET وPOST وPUT وDELETE)، وقد يكون أكثر ألفة إذا سبق لك العمل مع واجهات API التقليدية.
</Accordion>
<Accordion title="هل يمكنني تحديث السجلات الموجودة عبر API؟">
نعم! استخدم تحديثات mutations في GraphQL أو طلبات PUT/PATCH في REST مع `id` الخاص بالسجل.
</Accordion>
<Accordion title="كيف أتعامل مع التكرارات؟">
استعلم أولًا عن السجلات الموجودة باستخدام معرّفات فريدة (البريد الإلكتروني، النطاق). حدِّث إذا كان موجودًا، وأنشئ إذا لم يكن كذلك.
</Accordion>
<Accordion title="هل يمكنني حذف السجلات عبر API؟">
نعم، استخدم delete mutations في GraphQL أو طلبات DELETE في REST.
</Accordion>
<Accordion title="هل يوجد SDK لـ Python أو Node.js؟">
لا يتوفر ذلك في الوقت الحالي، لكن كلتا واجهتي API تعملان مع أي عميل HTTP بأي لغة.
</Accordion>
</AccordionGroup>
## وثائق API
للحصول على تفاصيل التنفيذ الكاملة وأمثلة الشيفرة ومرجع المخطط (schema):
* [وثائق API](/l/ar/developers/extend/api)

View File

@@ -0,0 +1,225 @@
---
title: استيراد العلاقات بين الكائنات عبر CSV
description: دليل كامل خطوة بخطوة لربط السجلات أثناء استيراد CSV.
---
## نظرة عامة
يأخذك هذا الدليل خلال استيراد العلاقات بين الكائنات—على سبيل المثال، ربط الأشخاص بالشركات، أو الفرص بالأشخاص.
<Note>**ما الذي يمكن استيراده:** العلاقات من واحد إلى متعدد التي تشير إلى نوع كائن واحد فقط. العلاقات التي تشير إلى أنواع كائنات متعددة (مثل ملاحظات مرتبطة بالأشخاص والشركات معًا) غير مدعومة للاستيراد بعد.</Note>
## فهم العلاقات
### ما هي علاقة "واحد إلى متعدد"؟
في علاقة واحد إلى متعدد:
* **شركة واحدة** لديها **العديد** من الأشخاص (الموظفين)
* **شركة واحدة** لديها **العديد** من الفرص
* **شخص واحد** لديه **العديد** من المهام
جانب "الواحد" هو **الأصل**. جانب "المتعدد" هو **التابع**.
### العلاقات الشائعة في Twenty
| علاقة | جانب "الواحد" (الأصل) | جانب "المتعدد" (التابع) |
| ------------------- | --------------------- | ----------------------- |
| الشركات → الأشخاص | الشركة | الأشخاص |
| الشركات → الفرص | الشركة | الفرص |
| الأشخاص → المهام | شخص | المهام |
| الأشخاص → الملاحظات | شخص | الملاحظات |
## الخطوة 1: تحديد جانبي "الواحد" و"المتعدد"
قبل الاستيراد، حدّد أي الكائنات هو الأصل وأيها التابع.
**اسأل نفسك:** "هل لدى كائن واحد من [Object A] العديد من [Object B]؟"
* شركة واحدة → العديد من الأشخاص ✓ (الشركة هي الأصل)
* شخص واحد → العديد من الشركات ✗ (هذا خطأ — الشخص ينتمي إلى شركة واحدة)
## الخطوة 2: استيراد سجلات الأصل أولًا
يجب أن يكون الأصل (جانب "الواحد") موجودًا في Twenty قبل أن تتمكّن من الإشارة إليه.
**ترتيب الاستيراد:**
1. **الشركات** أولًا (من دون تبعيات)
2. **الأشخاص** ثانيًا (مرتبطون بالشركات)
3. **الفرص** ثالثًا (مرتبطة بالشركات و/أو الأشخاص)
4. **المهام/الملاحظات** (مرتبطة بأي مما سبق)
<Warning>
**إذا كان سجل الأصل غير موجود، فسيفشل الاستيراد.**
تحقّق دائمًا من استيراد الشركات قبل استيراد الأشخاص الذين لديهم مراجع للشركات.
</Warning>
## الخطوة 3: تدوين المعرّف الفريد للأصل
تحتاج إلى الإشارة إلى سجل الأصل باستخدام **مُعرّف فريد**. الخيارات المتاحة:
| كائن الأصل | المُعرّفات الفريدة المتاحة |
| --------------------- | ---------------------------------------------------- |
| **الشركات** | `id` (UUID)، `domain` (موصى به)، أو أي حقل فريد مخصص |
| **الأشخاص** | `id` (UUID)، `email`، أو أي حقل فريد مخصص |
| **أعضاء مساحة العمل** | `id` (UUID)، `email` (ليس الاسم) |
| **كائنات مخصصة** | `id` (UUID)، أو أي حقل مميز كفريد |
<Note>**موصى به:** استخدم `domain` للشركات و`email` للأشخاص. هذه مقروءة للبشر وسهلة التحقّق منها في جدول البيانات الخاص بك.</Note>
### العثور على المعرّف
إذا كنت تحتاج إلى `id`:
1. صدّر سجلات الأصل من Twenty
2. يتضمن التصدير عمود `id`
3. استخدم هذه المعرّفات في ملف سجلات التابع
## الخطوة 4: التحقّق من وجود حقل العلاقة
قبل الاستيراد، تأكّد من وجود حقل العلاقة بين كائناتك.
**للتحقّق أو الإنشاء:**
1. اذهب إلى **الإعدادات → نموذج البيانات**
2. اختر كائن التابع الخاص بك (مثلًا، الأشخاص)
3. ابحث عن حقل علاقة يشير إلى الأصل (مثلًا، الشركة)
4. إذا لم يكن موجودًا، فقم بإنشائه:
* انقر **+ إضافة حقل**
* اختر نوع **العلاقة**
* اختر كائن الأصل
## الخطوة 5: جهّز ملف CSV الخاص بك
أضِف عمودًا إلى ملف CSV للتابع يشير إلى الأصل باستخدام مُعرّفه الفريد.
### مثال: ربط الأشخاص بالشركات
**ملف CSV الخاص بالأشخاص لديك:**
```csv
firstName,lastName,email,jobTitle,companyDomain
John,Smith,john@acme.com,CEO,https://acme.com
Jane,Doe,jane@widgets.co,CTO,https://widgets.co
Bob,Johnson,bob@techstart.io,Developer,https://techstart.io
```
يشير عمود `companyDomain` إلى نطاق الشركة.
### متطلبات التنسيق
| معرّف | التنسيق | مثال |
| ----------------- | ------------------- | -------------------------------------- |
| النطاق | تنسيق عنوان URL | `https://acme.com` |
| البريد الإلكتروني | بريد إلكتروني قياسي | `john@acme.com` |
| المعرف | UUID | `c776ee49-f608-4a77-8cc8-6fe96ae1e43f` |
<Warning>
**تنسيق النطاق مهم!**
استخدم `https://domain.com` (وليس فقط `domain.com`). هذا يتوافق مع طريقة تخزين Twenty لنطاقات الشركات ويمنع أخطاء المطابقة.
</Warning>
### قواعد مهمة
1. **تطابق تام مطلوب** — يجب أن تتطابق القيمة تمامًا مع سجل الأصل
2. **قم بتعيين مُعرّف فريد واحد فقط** — لا تُدرج كلًّا من `companyId` و`companyDomain`
3. **حسّاس لحالة الأحرف** — `Acme.com` ≠ `acme.com`
## الخطوة 6: ارفع الملف وعيّن العلاقة
1. انتقل إلى كائن التابع (مثلًا، الأشخاص)
2. انقر **⋮** → **Import records**
3. ارفع ملف CSV الخاص بك
4. في خطوة تعيين الحقول:
* اعثر على عمود العلاقة الخاص بك (مثلًا، `companyDomain`)
* طابقه مع حقل علاقة **Company**
5. أكمل التعيينات المتبقية
6. راجع الأخطاء وأكّد
سيقوم Twenty بربط كل سجل تابع تلقائيًا بالأصل المطابق.
## الخطوة 7: التحقّق من الاستيراد
بعد الاستيراد:
1. افتح عددًا قليلًا من سجلات التابع (مثلًا، الأشخاص)
2. تحقّق من أن حقل العلاقة يعرض الأصل الصحيح (مثلًا، الشركة)
3. افتح سجل الأصل وتفقّد قسم السجلات المرتبطة
## أخطاء شائعة يجب تجنّبها
| الخطأ | المشكلة | الحل |
| ------------------------- | ---------------------------------------------- | ----------------------------------------------------------- |
| **ترتيب استيراد خاطئ** | استيراد الأشخاص قبل الشركات | استورد دائمًا الأصول أولًا، ثم التوابع |
| **تنسيق نطاق غير صحيح** | استخدام `acme.com` بدلًا من `https://acme.com` | استخدم تنسيق عنوان URL الكامل مع `https://` |
| **حقول فريدة متعددة** | تعيين كلٍّ من `companyId` و`companyDomain` | قم بتعيين مُعرّف فريد واحد فقط |
| **حقل علاقة مفقود** | حقل العلاقة غير موجود في نموذج البيانات | قم بإنشائه ضمن **الإعدادات → نموذج البيانات** قبل الاستيراد |
| **سجلات غير موجودة** | سجل الأصل غير موجود في Twenty | استورد سجلات الأصل أولًا، أو تحقّق من الأخطاء الإملائية |
| **عدم تطابق حالة الأحرف** | `Acme.com` في الملف ولكن `acme.com` في Twenty | تأكّد من تطابق حالة الأحرف تمامًا |
## الربط بأعضاء مساحة العمل
عند الربط بأعضاء مساحة العمل (فريقك):
* استخدم **عنوان بريدهم الإلكتروني**، وليس اسمهم
* مثال: `owner@yourcompany.com`، وليس "John Smith"
```csv
taskName,assignedTo
Follow up with client,john@yourcompany.com
Review proposal,jane@yourcompany.com
```
## الأسئلة الشائعة
<AccordionGroup>
<Accordion title="ماذا لو لم يكن لدى سجل الأصل نطاق أو بريد إلكتروني؟">
لديك خياران:
1. استخدم `id` الخاص بـ Twenty (صدّر سجلات الأصل للحصول على معرّفاتها)
2. أنشئ حقلًا فريدًا مخصصًا في نموذج البيانات لتخزين معرّف خارجي من نظامك السابق
</Accordion>
<Accordion title="هل يمكنني تحديث العلاقات على السجلات الموجودة؟">
نعم! ضمّن المُعرّف الفريد لسجل التابع (مثلًا، `email` للأشخاص) وقيمة العلاقة الجديدة. سيقوم الاستيراد بتحديث العلاقة.
</Accordion>
<Accordion title="هل يمكنني استيراد علاقات عديدة-إلى-عدة؟">
العلاقات عديدة-إلى-عدة غير مدعومة للاستيراد بعد. هذا مُخطّط للنصف الأول من عام 2026.
</Accordion>
<Accordion title="هل يمكنني الربط بأنواع كائنات متعددة (مثل ربط الملاحظات بالأشخاص والشركات معًا)؟">
العلاقات التي تشير إلى أنواع كائنات متعددة غير مدعومة للاستيراد/التصدير بعد. هذا على خارطة الطريق لدينا.
</Accordion>
<Accordion title="ماذا يحدث إذا كان سجل الأصل غير موجود؟">
سيعرض الاستيراد خطأً لذلك الصف. يمكنك إما:
* استورد سجل الأصل أولًا، ثم أعد الاستيراد
* أصلِح قيمة المرجع
* أزل الصف من الاستيراد
</Accordion>
<Accordion title="لماذا لا يتم ربط العلاقة بشكل صحيح؟">
أسباب شائعة:
* تنسيق غير صحيح (استخدم `https://domain.com` للنطاقات)
* عدم تطابق حالة الأحرف (تحقّق من التهجئة الدقيقة)
* الأصل غير موجود (استورد الأصول أولًا)
* تعيين عدة مُعرّفات (استخدم واحدًا فقط)
</Accordion>
</AccordionGroup>
<Warning>
**تذكير: السجلات المحذوفة حذفًا ناعمًا تُحتسب ضمن التفرد.**
إذا كنت تتلقى أخطاء "not found" ولكن يبدو أن السجل موجود، فتحقّق من قائمة الأوامر → عرض السجلات المحذوفة. قد يكون السجل الأصل قد حُذِف حذفًا منطقيًا.
</Warning>
## استكشاف الأخطاء وإصلاحها
هل تواجه مشكلات؟ اطّلع على:
* [كيفية إصلاح أخطاء الاستيراد](/l/ar/user-guide/data-migration/how-tos/fix-import-errors)
* [قدرات استيراد العلاقات](/l/ar/user-guide/data-migration/capabilities/import-relations)
* [قيود التفرد](/l/ar/user-guide/data-migration/capabilities/uniqueness-constraints)

View File

@@ -0,0 +1,289 @@
---
title: الترحيل من CRMs أخرى
description: دليل خطوة بخطوة لترحيل بياناتك من أي نظام لإدارة علاقات العملاء إلى Twenty.
---
## نظرة عامة
يرشدك هذا الدليل خلال عملية ترحيل بياناتك من أي نظام لإدارة علاقات العملاء إلى Twenty. تشمل العملية تدقيق بياناتك، وإعداد مساحة العمل في Twenty، والتصدير من نظامك الحالي، والاستيراد إلى Twenty.
<Note>يجب إعادة إنشاء العروض، وسير العمل، والأذونات يدويًا بعد الترحيل. خطط وقتًا لهذا العمل الخاص بالإعداد.</Note>
## الخطوة 1: تدقيق بياناتك الحالية
يُعد الترحيل فرصة لبداية جديدة. لا تنقل البيانات غير الضرورية.
**ما يجب الاحتفاظ به:**
* جهات الاتصال والشركات النشطة
* الفرص والصفقات المفتوحة
* الملاحظات والأنشطة المهمة
* الحقول المخصصة التي تستخدمها فعليًا
**ما يجب تركه:**
* جهات الاتصال القديمة (لا نشاط خلال سنتين أو أكثر)
* السجلات المكررة
* بيانات الاختبار
* الحقول المخصصة غير المستخدمة
## الخطوة 2: مطابقة نموذج البيانات الخاص بك
أنشئ مستند مطابقة بين نظام إدارة علاقات العملاء الحالي لديك وTwenty:
| نظام إدارة علاقات العملاء الخاص بك | Twenty |
| ---------------------------------- | ---------------------- |
| حساب / مؤسسة | **الشركة** |
| جهة اتصال / شخص | **الأشخاص** |
| صفقة / فرصة | **الفرصة** |
| نشاط | **مهمة** أو **ملاحظة** |
| كائن مخصّص | **كائن مخصّص** |
**لكل حقل، سجّل:**
* اسم الحقل المصدر
* الحقل الهدف في Twenty
* أي تحويلات في التنسيق مطلوبة (التواريخ، أرقام الهاتف، إلخ.)
<Note>احتفظ بمستند التعيين هذا في متناول اليد أثناء الاستيراد — سترجع إليه عند تعيين الأعمدة.</Note>
## الخطوة 3: إعداد مساحة العمل الخاصة بك في Twenty
قبل استيراد البيانات، حضّر مساحة العمل لديك في Twenty:
### أنشئ كائنات وحقولًا مخصّصة
1. اذهب إلى **الإعدادات → نموذج البيانات**
2. أنشئ أي كائنات مخصّصة تحتاجها
3. أضِف حقولًا مخصّصة إلى الكائنات القياسية والمخصّصة
4. اضبط إعدادات الحقول (فريد، مطلوب، خيارات الاختيار، إلخ.)
<Warning>
**يجب أن تكون الحقول موجودة قبل الاستيراد.**
يُنشئ استيراد CSV سجلات، وليس حقولًا. أنشِئ جميع الحقول المخصّصة ضمن الإعدادات → نموذج البيانات قبل الاستيراد.
</Warning>
### ادعُ فريقك
<Warning>
**ادعُ المستخدمين قبل استيراد البيانات.**
إذا كانت بياناتك تتضمن مراجع للمستخدمين (مالك الحساب، المكلَّف، إلخ.)، فيجب أن يكون هؤلاء المستخدمون موجودين في Twenty قبل الاستيراد. وإلا فلن يمكن تعيين تلك العلاقات.
</Warning>
1. انتقل إلى **الإعدادات → الأعضاء**
2. ادعُ جميع أعضاء الفريق
3. **انتظر أن يقبل الجميع** دعوتهم
4. تحقّق من ظهور جميع المستخدمين في قائمة الأعضاء لديك
## الخطوة 4: التصدير من نظام إدارة علاقات العملاء الحالي لديك
صدّر بياناتك من نظام إدارة علاقات العملاء الحالي لديك:
1. ابحث عن وظيفة **Export** (عادةً ضمن الإعدادات، إدارة البيانات، أو المشرف)
2. صدّر إلى **تنسيق CSV** عند الإمكان
3. صدّر كل نوع من الكائنات على حدة (الشركات، جهات الاتصال، الصفقات، إلخ.)
4. ضمّن جميع الحقول التي تريد ترحيلها
**صدّر هذه الكائنات (بهذا الترتيب للرجوع إليه):**
1. الشركات / الحسابات / المؤسسات
2. جهات الاتصال / الأشخاص
3. الصفقات / الفرص
4. الملاحظات والأنشطة
5. كائنات مخصصة
## الخطوة 5: تنظيف بياناتك وتنسيقها
افتح كل ملف CSV مُصدَّر في تطبيق جداول بيانات وجهّزه لـ Twenty.
### أزل التكرارات
1. قم بالفرز حسب الحقل الفريد (البريد الإلكتروني للأشخاص، النطاق للشركات)
2. أزل الصفوف المكرّرة أو ادمجها
3. تحقّق من عدم وجود تكرارات مسبقًا في Twenty
### نسّق الحقول بشكل صحيح
| نوع الحقل | التنسيق المطلوب |
| --------------------- | ------------------------------------------- |
| **النطاق** | `https://domain.com` |
| **البريد الإلكتروني** | `name@domain.com` (يجب أن يكون فريدًا) |
| **تاريخ** | `YYYY-MM-DD` |
| **هاتف** | ثلاثة أعمدة: الرقم، رمز الدولة، رمز الاتصال |
| **قيمة منطقية** | `TRUE` أو `FALSE` (أحرف كبيرة) |
| **حقول الاختيار** | استخدم أسماء API، وليس تسميات العرض |
<Warning>
**تنسيق النطاق مهم.**
استخدم `https://domain.com` (وليس `domain.com` أو `www.domain.com`). هذا يتوافق مع تنسيق Twenty ويمنع التكرارات عند توصيل مزامنة البريد الإلكتروني/التقويم.
</Warning>
اطّلع على [كيفية إعداد ملفات CSV](/l/ar/user-guide/data-migration/how-tos/prepare-your-csv-files) لمعرفة متطلبات التنسيق الكاملة لجميع أنواع الحقول.
### أضِف أعمدة العلاقات
لربط السجلات (مثل ربط الأشخاص بالشركات)، أضِف عمودًا يحتوي على المعرّف الفريد للسجل الأصل.
**مثال: ملف CSV للأشخاص مع رابط الشركة**
```csv
firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co
```
اطّلع على [كيفية استيراد العلاقات](/l/ar/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) للحصول على إرشادات مفصّلة حول ربط السجلات.
### تحديث مراجع المستخدم
إذا كانت بياناتك تتضمن تعيينات للمستخدمين (المالك، المكلَّف):
1. أضِف عمودًا يحتوي على بريد المستخدم الإلكتروني (وليس فقط مُعرّفه من النظام القديم)
2. استخدم عناوين البريد الإلكتروني نفسها التي استخدمها المستخدمون للانضمام إلى مساحة العمل الخاصة بك في Twenty
اطّلع على [كيفية إعداد ملفات CSV](/l/ar/user-guide/data-migration/how-tos/prepare-your-csv-files) للحصول على دليل كامل للتنسيق.
## الخطوة 6: الاستيراد إلى Twenty
<Warning>
**ترتيب الاستيراد مهم!**
استورد دائمًا بهذا الترتيب:
1. **الشركات** أولًا (من دون تبعيات)
2. **الأشخاص** ثانيًا (مرتبطون بالشركات)
3. **الفرص** ثالثًا (مرتبطة بالشركات/الأشخاص)
4. **الملاحظات والمهام** (مرتبطة بالسجلات)
5. **الكائنات المخصّصة** وفقًا لتبعياتها
يجب أن يكون السجل الأصل موجودًا قبل أن تتمكّن من الإشارة إليه.
</Warning>
### استيراد كل كائن
لكل ملف CSV، بالتسلسل:
1. انتقل إلى الكائن في Twenty
2. انقر **⋮ → Import records**
3. ارفع ملف CSV
4. طابِق الأعمدة مع الحقول:
* طابِق أعمدة بريد المستخدم الإلكتروني مع حقول العلاقات المناسبة
* طابِق أعمدة العلاقات (مثل `companyDomain`) مع حقول العلاقات
5. راجِع وأصلِح أي أخطاء في واجهة المستخدم
6. أكِّد عملية الاستيراد
7. تحقّق من عدد قليل من السجلات قبل المتابعة إلى الملف التالي
**أدلة تفصيلية:**
* [كيفية استيراد الشركات](/l/ar/user-guide/data-migration/how-tos/import-companies-via-csv)
* [كيفية استيراد جهات الاتصال](/l/ar/user-guide/data-migration/how-tos/import-contacts-via-csv)
* [كيفية استيراد العلاقات](/l/ar/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
## الخطوة 7: عمليات ترحيل كبيرة (أكثر من 50,000 سجل)
لعمليات الترحيل الكبيرة:
| الحجم | النهج الموصى به |
| ------------------- | ---------------------------------- |
| أقل من 10,000 سجل | استيراد CSV واحد |
| 10,000 - 50,000 سجل | قسّم إلى عدة ملفات CSV |
| أكثر من 50,000 سجل | استخدم واجهة برمجة التطبيقات (API) |
**بالنسبة لعمليات الاستيراد عبر واجهة برمجة التطبيقات (API):**
* أسرع وأكثر موثوقية لمجموعات البيانات الكبيرة
* يدعم العمليات الدفعية (حتى 60 سجلًا لكل استدعاء)
* راجع [كيفية استيراد البيانات عبر واجهة برمجة التطبيقات (API)](/l/ar/user-guide/data-migration/how-tos/import-data-via-api)
## الخطوة 8: الإعداد بعد الترحيل
بعد استيراد البيانات، أكمل تهيئة مساحة العمل الخاصة بك:
### أعد إنشاء العروض
* أعد إعداد العروض المحفوظة مع عوامل التصفية والترتيب وتكوينات الأعمدة
* أنشئ أي عروض كانبان أو تقويم تحتاجها
### إعادة إنشاء سير العمل
* أعد إنشاء الأتمتة في **الإعدادات → سير العمل**
* ابدأ بسير العمل الأكثر أهمية
* اختبر كل واحد منها قبل الاعتماد عليه
### تكوين الأدوار والصلاحيات
* قم بإعداد الأدوار في **الإعدادات → الأعضاء → الأدوار**
* عيّن المستخدمين إلى الأدوار المناسبة
### اربط البريد الإلكتروني والتقويم
* يقوم كل مستخدم بربط حسابه الخاص ضمن **الإعدادات → الحسابات**
* سيبدأ Twenty بمزامنة رسائل البريد الإلكتروني مع سجلات جهات الاتصال
* اطّلع على [البريد الإلكتروني والتقويم](/l/ar/user-guide/calendar-emails/overview)
### درّب فريقك
* استعرضوا الواجهة الجديدة معًا
* قم بتوثيق أي عمليات خاصة بالفريق
## المشاكل الشائعة والحلول
| المشكلة | السبب | الحل |
| ------------------------ | ------------------------------------- | --------------------------------------------------------------------------------------- |
| **أخطاء التكرار** | البريد الإلكتروني/النطاق موجود بالفعل | أزل التكرارات من الملف، أو أدرج معرّفًا فريدًا لتحديث السجلات الموجودة |
| **العلاقة غير موجودة** | السجل الأصل غير موجود | استورد الكائنات الأصلية أولًا (الشركات قبل الأشخاص) |
| **حقول مفقودة** | الحقل المخصّص غير موجود | أنشئ الحقل ضمن الإعدادات → نموذج البيانات قبل الاستيراد |
| **أخطاء حقول الاختيار** | استخدام تسميات العرض | استخدم أسماء واجهة برمجة التطبيقات (API) (فعّل الوضع المتقدم في الإعدادات للعثور عليها) |
| **علاقة المستخدم فارغة** | لم يقبل المستخدم الدعوة | تأكّد من قبول جميع المستخدمين للدعوات قبل الاستيراد |
اطّلع على [كيفية إصلاح أخطاء الاستيراد](/l/ar/user-guide/data-migration/how-tos/fix-import-errors) للحصول على خطوات استكشاف الأخطاء وإصلاحها بالتفصيل.
## قائمة التحقق بعد التحويل
### سلامة البيانات
<Check>تم استيراد جميع السجلات (قارن الأعداد مع النظام المصدر)</Check>
<Check>العلاقات تعمل بشكل صحيح (الأشخاص مرتبطون بالشركات)</Check>
<Check>تعيينات المستخدمين تمت مطابقتها بشكل صحيح (المالك، المكلَّف)</Check>
<Check>تم ملء الحقول المخصّصة</Check>
<Check>لا توجد تكرارات غير متوقعة</Check>
### التكوين
<Check>تمت إعادة إنشاء العروض</Check>
<Check>تمت إعادة إنشاء سير العمل واختبارها</Check>
<Check>تم تكوين الأدوار والصلاحيات</Check>
<Check>تم ربط مزامنة البريد الإلكتروني/التقويم</Check>
### جاهزية الفريق
<Check>تم تدريب الفريق على النظام الجديد</Check>
<Check>تم تحديد خطة الوصول إلى نظام CRM القديم (الاحتفاظ به للرجوع إليه؟ متى يتم تعطيله؟)</Check>
## الأسئلة الشائعة
<AccordionGroup>
<Accordion title="هل يمكنني ترحيل سير العمل تلقائيًا؟">
ليس في الوقت الحالي. يجب إعادة إنشاء سير العمل يدويًا في Twenty.
</Accordion>
<Accordion title="ماذا عن مرفقات الملفات؟">
مرفقات الملفات غير متضمنة في صادرات CSV. ستحتاج إلى إعادة رفعها يدويًا، أو ترحيلها عبر واجهة برمجة التطبيقات (API)، أو التواصل مع فريقنا للحصول على المساعدة.
</Accordion>
<Accordion title="هل يمكنني إبقاء كلا النظامين يعملان أثناء الترحيل؟">
نعم، نوصي بإبقاء نظام CRM القديم يعمل حتى تتحقق من اكتمال عملية الترحيل. فقط احرص على عدم إنشاء بيانات جديدة في كلا المكانين.
</Accordion>
<Accordion title="كم يستغرق الترحيل عادةً؟">
يعتمد ذلك على حجم البيانات وتعقيدها. يمكن إنجاز عمليات الترحيل الصغيرة (أقل من 10,000 سجل) خلال بضع ساعات. قد تستغرق عمليات الترحيل الكبيرة عدة أيام بما في ذلك تنظيف البيانات والاختبار.
</Accordion>
</AccordionGroup>
## هل تحتاج إلى مساعدة؟
<Tip>
هل تريد مساعدة في عملية الترحيل؟ [اعثر على عشرين شريكاً معتمداً](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-migrate-crm) لنقل بياناتك، وخطوط الأنابيب، والمستخدمين من النهاية إلى النهاية.
</Tip>

View File

@@ -0,0 +1,173 @@
---
title: التحويل من نظام ذاتي الاستضافة إلى السحابة
description: دليل خطوة بخطوة لترحيل مثيل Twenty ذاتي الاستضافة الخاص بك إلى Twenty Cloud.
---
## نظرة عامة
يرشدك هذا الدليل خلال ترحيل بياناتك من مثيل Twenty ذاتي الاستضافة إلى Twenty Cloud. تتضمن العملية إعداد مساحة العمل السحابية الخاصة بك، وتصدير بياناتك، ثم إعادة استيرادها.
<Note>يجب إعادة إنشاء العروض، وسير العمل، والأدوار يدويًا بعد الترحيل. خطط وقتًا لهذا العمل الخاص بالإعداد.</Note>
## الخطوة 1: إنشاء مساحة العمل السحابية الخاصة بك
1. انتقل إلى [app.twenty.com](https://app.twenty.com) وأنشئ مساحة عمل جديدة
2. أكمل معالج الإعداد الأولي
3. دوّن عنوان URL لمساحة العمل الجديدة لديك
## الخطوة 2: إعادة إنشاء نموذج البيانات الخاص بك
قبل استيراد البيانات، أعد إنشاء الكائنات والحقول المخصّصة لديك:
1. انتقل إلى **الإعدادات → نموذج البيانات** في مثيلك السحابي
2. أنشئ كائنات مخصّصة تتطابق مع إعدادك ذاتي الاستضافة
3. أضف حقولًا مخصّصة إلى الكائنات القياسية والمخصّصة
4. قم بضبط إعدادات الحقول (فريد، مطلوب، إلخ.)
<Note>التقط لقطات شاشة لنموذج البيانات ذاتي الاستضافة لديك كمرجع، أو اترك المثيلين مفتوحين جنبًا إلى جنب.</Note>
## الخطوة 3: دعوة جميع المستخدمين
<Warning>
**هام: قم بدعوة المستخدمين قبل استيراد البيانات.**
يجب على المستخدمين قبول دعواتهم قبل أن تستورد أي سجلات تُشير إليهم (مثل حقول مالك الحساب). إذا لم يكن المستخدمون موجودين بعد، فلن يمكن تعيين تلك العلاقات.
</Warning>
1. انتقل إلى **الإعدادات → الأعضاء** في مثيلك السحابي
2. ادعُ جميع أعضاء الفريق الذين كانت لديهم حسابات على المثيل ذاتي الاستضافة
3. **انتظر أن يقبل الجميع** دعواتهم
4. تحقق من ظهور جميع المستخدمين في قائمة الأعضاء لديك
## الخطوة 4: تصدير البيانات من المثيل ذاتي الاستضافة
صدِّر كل كائن من مثيلك ذاتي الاستضافة:
1. انتقل إلى كل كائن (الشركات، الأشخاص، الفرص، إلخ.)
2. قم بإعداد العرض ليُظهر **جميع الأعمدة** التي تريد ترحيلها
3. انقر **⋮ → Export view**
4. احفظ كل ملف CSV باسم واضح (مثلًا، `companies-export.csv`)
**صدِّر بالترتيب التالي** (للرجوع إليه عند الاستيراد):
1. الشركات
2. الأشخاص
3. الفرص
4. الكائنات المخصّصة (وفقًا لتبعياتها)
5. المهام، الملاحظات
## الخطوة 5: تحديث مراجع أعضاء مساحة العمل
تحتوي ملفات CSV المُصدَّرة على معرّفات المستخدمين من مثيلك ذاتي الاستضافة. هذه المعرّفات لن تتطابق مع مثيلك السحابي، لذا تحتاج إلى استبدالها بعناوين البريد الإلكتروني.
**لكل ملف CSV يحتوي على مراجع للمستخدمين (المالك، المسند إليه، إلخ.):**
1. افتح ملف CSV في تطبيق جداول بيانات
2. أضِف عمودًا جديدًا بجوار كل عمود لمعرّف المستخدم (مثلًا، `accountOwnerEmail` بجوار `accountOwnerId`)
3. املأ **عنوان البريد الإلكتروني** لكل مستخدم
4. يمكنك حذف عمود المعرّف القديم أو تركه (سيتم تخطيه أثناء الاستيراد)
**مثال:**
قبل:
```csv
name,domain,accountOwnerId
Acme Corp,https://acme.com,old-uuid-123
```
بعد:
```csv
name,domain,accountOwnerEmail
Acme Corp,https://acme.com,john@yourcompany.com
```
<Note>استخدم عناوين البريد الإلكتروني نفسها التي استخدمها المستخدمون لقبول دعوتهم إلى مساحة العمل السحابية.</Note>
## الخطوة 6: التخطيط لترتيب الاستيراد
استورد الملفات بالترتيب الصحيح للحفاظ على العلاقات:
1. **الشركات** أولًا (من دون تبعيات)
2. **الأشخاص** ثانيًا (مرتبطون بالشركات)
3. **الفرص** ثالثًا (مرتبطة بالشركات والأشخاص)
4. **الكائنات المخصّصة** (وفقًا لتبعياتها)
5. **المهام والملاحظات** أخيرًا (مرتبطة بسجلات أخرى)
اطّلع على [كيفية استيراد العلاقات](/l/ar/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) لمعرفة تفاصيل الحفاظ على العلاقات.
## الخطوة 7: الاستيراد إلى السحابة
لكل ملف CSV، بالتسلسل:
1. انتقل إلى الكائن في مثيلك السحابي
2. انقر **⋮ → Import records**
3. ارفع ملف CSV
4. طابق الأعمدة مع الحقول:
* طابِق أعمدة بريد المستخدم الإلكتروني مع حقول العلاقات المناسبة
* طابق الأعمدة الأخرى كالمعتاد
5. راجِع وأصلِح أي أخطاء
6. أكِّد عملية الاستيراد
7. تحقّق من عدد قليل من السجلات قبل المتابعة إلى الملف التالي
## الخطوة 8: إعادة إنشاء الإعدادات
بعد استيراد البيانات، أعد إنشاء ما يلي يدويًا:
### العروض
* أعد إنشاء العروض المحفوظة مع عوامل التصفية والترتيب وتكوينات الأعمدة
* قم بإعداد أي عروض كانبان أو تقويم
### سير العمل
* أعد إنشاء الأتمتة في **الإعدادات → سير العمل**
* اختبر كل سير عمل قبل الاعتماد عليه
### الأدوار والصلاحيات
* قم بتكوين الأدوار في **الإعدادات → الأعضاء → الأدوار**
* عيّن المستخدمين إلى الأدوار المناسبة
### التكاملات
* أعد توصيل مزامنة البريد الإلكتروني والتقويم لكل مستخدم
* أعد تكوين أي تكاملات API بمفاتيح API جديدة
## قائمة التحقق بعد التحويل
<Check>تم استيراد جميع البيانات بنجاح</Check>
<Check>العلاقات بين الكائنات تعمل بشكل صحيح</Check>
<Check>تعيينات المستخدمين (المالك، المسند إليه) تمت مطابقتها بشكل صحيح</Check>
<Check>تمت إعادة إنشاء العروض</Check>
<Check>تمت إعادة إنشاء سير العمل واختبارها</Check>
<Check>تم تكوين الأدوار والصلاحيات</Check>
<Check>تمت إعادة توصيل مزامنة البريد الإلكتروني/التقويم</Check>
<Check>تم تحديث تكاملات API بمفاتيح جديدة</Check>
## الأسئلة الشائعة
<AccordionGroup>
<Accordion title="هل يمكنني ترحيل سير العمل تلقائيًا؟">
ليس في الوقت الحالي. يجب إعادة إنشاء سير العمل يدويًا في مثيلك السحابي.
</Accordion>
<Accordion title="ماذا عن مرفقات الملفات والصور؟">
مرفقات الملفات غير متضمنة في صادرات CSV. ستحتاج إلى إعادة رفع أي مرفقات يدويًا، أو ترحيلها عبر API، أو التواصل مع فريقنا للحصول على المساعدة في عمليات الترحيل الكبيرة.
</Accordion>
<Accordion title="هل يمكنني إبقاء المثيلين يعملان أثناء الترحيل؟">
نعم، نوصي بإبقاء مثيلك ذاتي الاستضافة قيد التشغيل حتى تتحقق من اكتمال الترحيل إلى السحابة. فقط احرص على عدم إنشاء بيانات جديدة في كلا المكانين.
</Accordion>
<Accordion title="ماذا لو لم يقبل مستخدم دعوته بعد؟">
السجلات التي تُشير إلى ذلك المستخدم ستفشل في الاستيراد أو ستكون العلاقة فارغة. تأكّد من أن جميع المستخدمين يقبلون الدعوات قبل استيراد البيانات.
</Accordion>
</AccordionGroup>
## هل تحتاج إلى مساعدة؟
<Tip>
هل تقوم بترحيل مساحة عمل كبيرة أو معقدة؟ [احصل على شريك Twenty معتمد](https://twenty.com/partners/list?categories=HOSTING\&ref=docs-migrate-cloud) ليتولى عملية النقل من البداية إلى النهاية. *(أو أشرك فريقنا في العملية: [contact@twenty.com](mailto:contact@twenty.com).)*
</Tip>

View File

@@ -0,0 +1,267 @@
---
title: إعداد ملفات CSV الخاصة بك
description: دليل كامل خطوة بخطوة لتنسيق بياناتك لاستيرادها إلى Twenty.
---
## نظرة عامة
يرشدك هذا الدليل إلى كيفية إعداد ملف CSV لاستيراد ناجح. اتّبع هذه الخطوات لتجنّب الأخطاء.
## الخطوة 1: التحقّق من متطلبات الملف
قبل البدء، تأكّد من أنّ ملفك يستوفي هذه المتطلبات:
| المتطلب | تفاصيل |
| --------------------- | --------------------- |
| **التنسيق** | CSV، XLSX، أو XLS |
| **الحد الأقصى للحجم** | 10,000 سجل لكل ملف |
| **الترميز** | يوصى باستخدام UTF-8 |
| **البنية** | نوع كائن واحد لكل ملف |
<Note>بالنسبة لمجموعات البيانات التي تزيد على 10,000 سجل، قم بتقسيمها إلى عدة ملفات أو استخدم [الاستيراد عبر API](/l/ar/user-guide/data-migration/how-tos/import-data-via-api).</Note>
## الخطوة 2: تنزيل الملف النموذجي
**هذه هي أهم خطوة.** يوضّح لك الملف النموذجي أسماء الأعمدة الدقيقة والتنسيق الذي تتوقعه Twenty.
1. انتقل إلى عرض الكائن (الأشخاص، الشركات، إلخ)
2. انقر **⋮** → **استيراد السجلات**
3. انقر **تنزيل الملف النموذجي**
4. استخدم هذا الملف كقالب
<Note>**نصيحة احترافية:** بدلًا من ذلك، صدِّر عددًا قليلًا من السجلات الموجودة. سيوفّر لك هذا أمثلة حقيقية على كيفية تنسيق البيانات، كما ستُطابَق أسماء الأعمدة تلقائيًا أثناء الاستيراد.</Note>
## الخطوة 3: إزالة القيم المكررة
تفرض Twenty التفرّد على حقول معيّنة. ستتسبب القيَم المكررة في أخطاء أثناء الاستيراد.
| كائن | الحقول الفريدة |
| ---------------- | ------------------------------------- |
| **الأشخاص** | `id`, `email` |
| **الشركات** | `id`, `domain` |
| **كائنات مخصصة** | `id`، بالإضافة إلى أي حقل وضعته كفريد |
**قبل الاستيراد:**
1. قم بفرز جدول البيانات حسب الحقل الفريد (البريد الإلكتروني أو النطاق)
2. أزِل الصفوف المكررة أو ادمجها
3. تحقّق من التكرارات الموجودة مسبقًا في Twenty
<Warning>**السجلات المحذوفة مؤقتًا تُحتسب ضمن التفرّد.** السجلات الموجودة في قائمة الأوامر → عرض السجلات المحذوفة ستتسبب في أخطاء تكرار. احذفها نهائيًا أو استعدها وقم بتحديثها.</Warning>
## الخطوة 4: تنسيق كل نوع من الحقول بشكل صحيح
تتطلب أنواع الحقول المختلفة تنسيقات محددة. إليك المرجع الكامل:
### حقول النص
* لا يلزم تنسيق خاص
* تُزال الفراغات في البداية والنهاية تلقائيًا
### حقول البريد الإلكتروني
* يجب أن يكون بتنسيق بريد إلكتروني صالح: `name@domain.com`
* يجب أن تكون فريدة (بدون تكرارات في الملف أو في Twenty)
* للعناوين الإضافية للبريد الإلكتروني، استخدم هذا التنسيق في عمود **Emails / Additional Emails**:
```
["jane@twenty.com","jane.doe@twenty.com"]
```
### حقول النطاق
* **التنسيق الموصى به**: `https://domain.com`
* يتطابق هذا مع التنسيق المستخدم في مزامنة صندوق البريد/التقويم (يمنع التكرارات)
* املأ كلا العمودين:
* **Domain / Domain Label**: `domain.com`
* **Domain / Domain URL**: `https://domain.com`
* يجب أن تكون فريدة داخل ملفك وفي Twenty
### حقول الهاتف
الهاتف حقل **متداخل** يتطلب عدة أعمدة:
| العمود | مثال |
| --------------------------------------- | ------------ |
| **Phones / Primary Phone Number** | `4159095555` |
| **Phones / Primary Phone Country Code** | `US` |
| **Phones / Primary Phone Calling Code** | `+1` |
### حقول العنوان
العنوان هو **حقل متداخل** يحتوي على أعمدة متعددة (يمكن ترك بعضها فارغًا):
* **العنوان / العنوان 1**: السطر الأول لعنوان الشارع
* **العنوان / العنوان 2**: السطر الثاني لعنوان الشارع (اختياري)
* **العنوان / المدينة**: اسم المدينة
* **العنوان / الولاية**: ولاية أو مقاطعة
* **العنوان / البلد**: اسم البلد
* **العنوان / الرمز البريدي**: رمز بريدي/ZIP
### حقول التاريخ
استخدم تنسيقًا موحدًا في كامل ملفك:
* `YYYY-MM-DD` (مُوصى به): `2024-03-15`
* ISO 8601: `2024-03-15T10:30:00Z`
### حقول الأرقام
* أرقام فقط (بدون نص)
* استخدم النقطة للفواصل العشرية: `1234.56`
* بدون فواصل لآلاف الأرقام (ليس `1,234.56`)
### حقول العملة
العملة هي **حقل متداخل** يتطلب عمودين يجب **ملؤهما كليهما**:
| العمود | مثال |
| ------------------- | --------- |
| **المبلغ / المبلغ** | `1234.56` |
| **المبلغ / العملة** | `USD` |
### حقول منطقية
استخدم أحرفًا كبيرة: `TRUE` أو `FALSE`
<Warning>الأحرف الصغيرة `true` أو `false` لن تعمل.</Warning>
### اختر الحقول
استخدم **اسم واجهة برمجة التطبيقات (API)** للخيار، وليس اسم العرض.
**كيفية العثور على أسماء واجهة برمجة التطبيقات (API):**
1. انتقل إلى **الإعدادات → نموذج البيانات**
2. اختر الكائن والحقل
3. فعّل **الوضع المتقدم** (المبدّل في أسفل اليمين)
4. انسخ اسم واجهة برمجة التطبيقات (مثال: `OPTION_1`، وليس "Option 1")
<Note>خيارات الاختيار الجديدة لا يتم إنشاؤها تلقائيًا. أضِفها في **الإعدادات → نموذج البيانات** قبل الاستيراد.</Note>
### حقول متعددة الاختيار
استخدم أسماء واجهة برمجة التطبيقات بصيغة المصفوفة:
```
["VALUE1","VALUE2"]
```
### حقول المصفوفة
استخدم صيغة مصفوفة JSON:
```
["value1","value2"]
```
### حقول التقييم
استخدم الصيغة: `RATING_1` و`RATING_2` و`RATING_3` و`RATING_4` أو `RATING_5`
### حقول الروابط/عناوين URL
املأ كلا العمودين:
* **الروابط / تسمية الرابط**: `Twenty`
* **الروابط / عنوان URL للرابط**: `https://twenty.com`
بالنسبة للروابط الثانوية، استخدم عمود **الروابط / الروابط الثانوية**:
```
[{"url":"https://twenty.com","label":"Twenty"}]
```
### حقول JSON
استخدم تنسيق JSON صالحًا:
```
{"key":"value","key2":"value2"}
```
### حقول المعرّف
* **اختياري**: يقوم Twenty بإنشاء المعرّفات تلقائيًا إذا لم تُوفَّر
* **التنسيق**: UUID (مثلًا: `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`)
* **حالة الاستخدام**: تضمين المعرّف لتحديث السجلات الموجودة بدلًا من إنشاء سجلات جديدة
## الخطوة 5: إضافة أعمدة العلاقات (إذا كنت تربط السجلات)
لربط السجلات بكائنات أخرى (مثل الأشخاص بالشركات)، أضِف عمودًا يحتوي على المعرّف الفريد للسجل المرتبط.
**مثال**: ربط الأشخاص بالشركات
أضِف عمودًا إلى ملف CSV الخاص بالأشخاص:
```
firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co
```
**قواعد مهمة للعلاقات:**
* يجب أن يكون السجل الأب موجودًا مسبقًا في Twenty
* استخدم صيغة **عنوان المجال (Domain URL)** (`https://domain.com`) وليس التسمية
* قم بربط مُعرّف فريد واحد فقط (لا تُدرج كلاً من `companyId` و`companyDomain`)
* بالنسبة لأعضاء مساحة العمل، استخدم **البريد الإلكتروني** الخاص بهم (وليس الاسم)
<Warning>
**ترتيب الاستيراد مهم!**
استورد طرف "الواحد" قبل طرف "الكثير":
1. **الشركات** أولاً
2. **الأشخاص** ثانيًا (مع مرجع الشركة)
3. **الفرص** ثالثًا
يجب أن يوجد السجل الأب قبل أن تتمكن من الإشارة إليه.
</Warning>
اطلع على [كيفية استيراد العلاقات](/l/ar/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) للحصول على تعليمات مفصلة.
## الخطوة 6: تأكد من وجود الحقول في Twenty
تقوم عملية الاستيراد بإنشاء **سجلات**، وليس **حقولًا**. يجب أن تكون جميع الحقول التي تريد استيرادها موجودة مسبقًا في نموذج البيانات لديك.
**قبل الاستيراد:**
1. انتقل إلى **الإعدادات → نموذج البيانات**
2. اختر الكائن الخاص بك
3. أنشئ أي حقول مخصصة تحتاجها
4. دوّن أسماء الحقول بدقة (يجب أن تتطابق مع عناوين أعمدتك)
## الخطوة 7: قائمة التحقق النهائية
قبل رفع ملفك، تحقّق مما يلي:
<Check>الملف بصيغة CSV أو XLSX أو XLS</Check>
<Check>يحتوي الملف على أقل من 10,000 سجل</Check>
<Check>الترميز UTF-8</Check>
<Check>لا توجد رسائل بريد إلكتروني مكررة (للأشخاص) أو نطاقات (للشركات)</Check>
<Check>التواريخ تستخدم تنسيقًا موحدًا طوال الملف</Check>
<Check>النطاقات تستخدم الصيغة `https://domain.com`</Check>
<Check>الحقول المنطقية تستخدم `TRUE` أو `FALSE` (أحرف كبيرة)</Check>
<Check>حقول الاختيار تستخدم أسماء واجهة برمجة التطبيقات، وليس أسماء العرض</Check>
<Check>جميع الحقول المخصصة موجودة في الإعدادات → نموذج البيانات</Check>
<Check>تم استيراد السجلات الأصلية قبل السجلات الفرعية</Check>
<Check>أعمدة العلاقات تشير إلى سجلات موجودة</Check>
## أخطاء شائعة يجب تجنبها
| الخطأ | الحل |
| ---------------------------------- | ----------------------------------------------------------- |
| استخدام `true` بدلًا من `TRUE` | يجب أن تكون القيم المنطقية بأحرف كبيرة |
| استخدام أسماء العرض لحقول الاختيار | اعثر على أسماء واجهة برمجة التطبيقات في الإعدادات واستخدمها |
| استيراد الأشخاص قبل الشركات | احرص دائمًا على استيراد الكائنات الأصل أولًا |
| رمز العملة مفقود لحقول العملة | املأ عمودي المبلغ والعملة معًا |
| تنسيق نطاق غير صحيح | استخدم `https://domain.com` بصورة متسقة |
| ربط عدة حقول فريدة للعلاقات | اربط حقلًا واحدًا فقط (النطاق أو المعرّف، وليس كليهما) |
## الخطوات التالية
ملفك جاهز! الآن:
* [استيراد الشركات](/l/ar/user-guide/data-migration/how-tos/import-companies-via-csv) (قم باستيرادها أولًا)
* [استيراد جهات الاتصال](/l/ar/user-guide/data-migration/how-tos/import-contacts-via-csv)
* [إصلاح أي أخطاء في الاستيراد](/l/ar/user-guide/data-migration/how-tos/fix-import-errors)

View File

@@ -0,0 +1,198 @@
---
title: تحديث السجلات الموجودة عبر الاستيراد
description: دليل كامل خطوة بخطوة لتحديث السجلات بشكل مجمّع باستخدام استيراد CSV.
---
## نظرة عامة
هل تحتاج إلى تحديث العديد من السجلات دفعة واحدة؟ بدلاً من تعديلها واحدًا تلو الآخر، استخدم استيراد CSV لتحديث السجلات الموجودة بشكل مجمّع.
**حالات الاستخدام:**
* حدّث المسمّيات الوظيفية لعدة أشخاص
* غيّر معلومات الشركة بشكل مجمّع
* أضِف بيانات إلى حقول مخصّصة جديدة
* صحّح أخطاء البيانات عبر العديد من السجلات
## كيف يعمل
عند استيراد ملف يحتوي على **معرّف فريد** يطابق سجلًا موجودًا، يقوم Twenty بتحديث ذلك السجل بدلاً من إنشاء نسخة مكررة.
| إذا كان المعرّف الفريد... | سيقوم Twenty بـ... |
| ------------------------- | ------------------------------------------------ |
| يطابق سجلًا موجودًا | **تحديث** السجل الموجود |
| لا يطابق أي سجل | **إنشاء** سجل جديد |
| مفقود من ملفك | **إنشاء** سجل جديد (بمُعرّف يتم إنشاؤه تلقائيًا) |
<Warning>
**يتم استبدال حقول الاختيار المتعدد، ولا يتم دمجها.**
إذا كان السجل محدّدًا فيه `Option A` و`Option B`، وقمتَ باستيراد `["Option C"]`، فسيحتوي السجل على `Option C` فقط بعد الاستيراد. تستبدل عملية الاستيراد جميع الاختيارات السابقة — ولا تضيف إليها.
للاحتفاظ بالقيم الحالية، ضمّنها جميعًا في عملية الاستيراد: `["Option A","Option B","Option C"]`
</Warning>
## الخطوة 1: تصدير بياناتك الحالية
أولًا، صدّر السجلات التي تريد تحديثها:
1. انتقل إلى الكائن (الأشخاص، الشركات، إلخ)
2. **أضِف الأعمدة التي تحتاجها** — انقر **Options → Fields** لعرض الحقول التي تريد تحديثها
3. **رشّح إذا لزم الأمر** — ضيّق النطاق ليقتصر على السجلات التي تريد تحديثها
4. انقر **⋮** → **Export view**
5. احفظ ملف CSV
<Note>**لماذا نُصدِّر أولًا؟** يحتوي الملف المُصدَّر على التنسيق الصحيح، ويتضمن معرّفات فريدة، ويتم تعيينه تلقائيًا أثناء الاستيراد.</Note>
### ما الذي يتم تصديره
* جميع الأعمدة المرئية في العرض الحالي
* المعرّفات الفريدة للسجل (`id`، `email`، `domain`)
* قيم الحقول الحالية التي يمكنك تعديلها
## الخطوة 2: تحرير ملف CSV
افتح الملف المُصدَّر في تطبيق الجداول الحسابية لديك (Excel، Google Sheets، إلخ):
1. **أبقِ عمود المعرّف الفريد** — لا تحذف `id` أو `email` أو `domain`
2. **حدّث القيم** في الأعمدة التي تريد تغييرها
3. **أزِل الأعمدة التي لا تحتاج إلى تحديثها** (اختياري، لكنه أنظف)
4. **لا تغيّر قيم المعرّفات الفريدة** — وإلا فسيقوم Twenty بإنشاء سجلات جديدة
### مثال: تحديث المسمّيات الوظيفية
**الملف المُصدَّر:**
```csv
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Sales Rep
550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Sales Rep
550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Sales Rep
```
**بعد تعديلاتك:**
```csv
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Account Executive
550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Senior Account Executive
550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Account Executive
```
<Warning>
**لا تغيّر قيم المعرّفات الفريدة.**
إذا غيّرتَ `john@acme.com` إلى `john.smith@acme.com`، فسيقوم Twenty بإنشاء سجل جديد بدلاً من تحديث السجل الموجود.
</Warning>
## الخطوة 3: استيراد الملف المُحدَّث
1. انتقل إلى الكائن
2. انقر **⋮** → **Import records**
3. حمّل ملف CSV الذي تم تحريره
4. **تأكّد من تعيين المعرّف الفريد** — تحقّق من تعيين `email` أو `domain` أو `id` بشكل صحيح
5. راجع تعيينات الحقول
6. تحقّق من الأخطاء
7. انقر **Confirm**
يطابق Twenty السجلات باستخدام المعرّف الفريد ويحدّثها بالقيم الجديدة.
## اختيار المعرّف الفريد المناسب
| كائن | مُوصى به | بديل | الملاحظات |
| ---------------- | ------------------- | ---- | -------------------------------- |
| **الأشخاص** | `البريد الإلكتروني` | `id` | البريد الإلكتروني مقروء للبشر |
| **الشركات** | `النطاق` | `id` | النطاق مقروء للبشر |
| **كائنات مخصصة** | أي حقل فريد | `id` | استخدم الحقل الفريد المخصّص لديك |
<Note>**استخدم مُعرّفًا فريدًا واحدًا فقط.** لا تقُم بتعيين كلٍّ من `email` و`id`. قد يسبب هذا ارتباكًا وأخطاء.</Note>
### استخدام حقول فريدة مخصّصة
إذا كان لديك حقل مخصّص مُعلَّم كفريد (مثل مُعرّف خارجي من نظام آخر):
1. ضمّن ذلك الحقل في التصدير والاستيراد
2. قم بتعيينه أثناء الاستيراد
3. سيطابق Twenty بناءً على ذلك الحقل
## الخطوة 4: التحقق من التحديثات
بعد الاستيراد:
1. افتح بعض السجلات التي تم تحديثها
2. تحقّق من تطبيق التغييرات
3. تحقّق من عدم إنشاء سجلات مكررة
## ماذا عن الحقول غير الموجودة في ملفك؟
**الحقول غير المُدرجة في ملف الاستيراد تبقى دون تغيير.**
| يحتوي ملفك على... | النتيجة |
| ---------------------------- | ---------------------------------------------------- |
| `email`, `jobTitle` | يتم تحديث `jobTitle` فقط؛ وتبقى الحقول الأخرى كما هي |
| `email`, `jobTitle`, `phone` | يتم تحديث `jobTitle` و`phone` |
هذا يعني أنك تحتاج فقط إلى تضمين الحقول التي تريد تغييرها (بالإضافة إلى المعرّف الفريد).
## الجمع بين التحديثات والسجلات الجديدة
يمكنك تحديث السجلات الموجودة وإنشاء سجلات جديدة في نفس عملية الاستيراد:
```csv
email,firstName,lastName,jobTitle
john@acme.com,John,Smith,Senior Manager ← Updates existing (email matches)
newperson@acme.com,New,Person,Analyst ← Creates new (email doesn't match)
```
## أخطاء شائعة يجب تجنّبها
| الخطأ | المشكلة | النتيجة | الحل |
| ------------------------- | -------------------------------------------------------------------- | ----------------------------------- | -------------------------------------------- |
| **تغيير المعرّف الفريد** | تغيير `john@acme.com` إلى `john.smith@acme.com` | يُنشئ سجلًا جديدًا بدلًا من التحديث | أبقِ المعرّفات الفريدة كما هي |
| **حقول فريدة متعددة** | تعيين كلٍّ من `email` و`id` | احتمال حدوث تعارضات في المطابقة | قم بتعيين مُعرّف فريد واحد فقط |
| **لا يوجد معرّف فريد** | يحتوي الملف فقط على `firstName` و`lastName` و`jobTitle` | كل الصفوف تُنشئ سجلات جديدة | قم دائمًا بتضمين `email` أو `domain` أو `id` |
| **عدم تطابق حالة الأحرف** | الملف يحتوي على `John@acme.com` لكن Twenty يحتوي على `john@acme.com` | ينشئ سجلًا جديدًا | صدّر من Twenty للحصول على القيم الدقيقة |
## الأسئلة الشائعة
<AccordionGroup>
<Accordion title="ماذا لو لم تكن بعض السجلات موجودة بعد؟">
السجلات ذات المعرّفات الفريدة التي لا تطابق سجلات موجودة سيتم إنشاؤها كسجلات جديدة. يتيح لك هذا التحديث والإنشاء في نفس عملية الاستيراد.
</Accordion>
<Accordion title="هل يمكنني مسح/إفراغ قيمة حقل؟">
نعم، اترك الخلية فارغة في ملف CSV. ستقوم عملية الاستيراد بمسح قيمة ذلك الحقل في السجل الموجود.
</Accordion>
<Accordion title="ماذا يحدث للحقول التي لا أضمّنها في الاستيراد؟">
الحقول غير الموجودة في ملف الاستيراد تبقى دون تغيير في السجلات الموجودة. يتم تحديث الحقول التي تضمّنها فقط.
</Accordion>
<Accordion title="هل يمكنني تحديث حقول العلاقات (مثل الشركة)؟">
نعم! ضمّن المعرّف الفريد للعلاقة (مثلًا، `companyDomain`) وعيّنه لحقل العلاقة. سيتم تحديث العلاقة.
</Accordion>
<Accordion title="كيف أعرف أي السجلات سيتم تحديثها وأيها سيتم إنشاؤه؟">
أثناء خطوة مراجعة الاستيراد، يعرض لك Twenty عدد السجلات التي سيتم تحديثها مقابل إنشائها بناءً على تطابقات المعرّف الفريد.
</Accordion>
<Accordion title="هل يمكنني التراجع عن تحديث مجمّع؟">
لا يوجد تراجع تلقائي. نوصي بتصدير بياناتك كنسخة احتياطية قبل إجراء تحديثات مجمّعة.
</Accordion>
</AccordionGroup>
## أفضل الممارسات
1. **ابدأ بالتصدير أولًا** — ابدأ دائمًا من تصدير لضمان التنسيق الصحيح
2. **قم بإنشاء نسخة احتياطية قبل التحديث** — صدّر بياناتك قبل إجراء تغييرات مجمّعة
3. **اختبر على عدد قليل من السجلات** — جرّب تحديث 5–10 سجلات أولًا قبل تنفيذ دفعة كبيرة
4. **استخدم معرّفات مقروءة للبشر** — يعدّ `email` و`domain` أسهل في التحقق منهما من `id`
5. **ضمّن الأعمدة اللازمة فقط** — فكلما قلّ عدد الأعمدة قلّ احتمال حدوث الأخطاء
## استكشاف الأخطاء وإصلاحها
هل تواجه مشكلات؟ اطّلع على:
* [كيفية إصلاح أخطاء الاستيراد](/l/ar/user-guide/data-migration/how-tos/fix-import-errors)
* [قيود التفرد](/l/ar/user-guide/data-migration/capabilities/uniqueness-constraints)
* [مرجع تعيين الحقول](/l/ar/user-guide/data-migration/capabilities/field-mapping)

View File

@@ -0,0 +1,83 @@
---
title: نقل البيانات
description: استيراد وتصدير بيانات CRM عبر ملفات CSV أو عبر API.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## طرق الاستيراد
تدعم Twenty طريقتين رئيستين لاستيراد البيانات:
| طريقة | الأفضل لـ | حد الحجم |
| --------------------- | ----------------------------------- | ------------------ |
| **استيراد CSV** | عمليات ترحيل قياسية، تحديثات منتظمة | 10,000 سجل لكل ملف |
| **الاستيراد عبر API** | عمليات ترحيل واسعة النطاق، أتمتة | غير محدود |
<Note>بالنسبة لمجموعات البيانات الكبيرة جداً (مئات الآلاف من السجلات)، استخدم API. يمكن لشركائنا في [التنفيذ](/l/ar/user-guide/getting-started/capabilities/implementation-services) المساعدة في تشغيل هذه النصوص البرمجية عند الحاجة.</Note>
## أساسيات استيراد CSV
يمكنك استيراد البيانات لأي جسم باستخدام ملفات CSV أو XLSX أو XLS. يجب أن يحتوي كل ملف على **نوع واحد فقط من الأجسام** (مثلًا، سجلات الأشخاص فقط).
<Note>**يجب أن تكون الحقول موجودة قبل الاستيراد.** يؤدي رفع ملف CSV إلى إنشاء سجلات لكنه لا ينشئ حقولاً. إذا كنت تحتاج إلى حقول مخصّصة، فأنشئها أولاً ضمن **الإعدادات → نموذج البيانات**.</Note>
### الخطوات
1. انتقل إلى الجسم الذي تريد استيراد البيانات إليه
2. انقر أيقونة **⋮** في أعلى اليمين (هذه هي قائمة الأوامر) ثم انقر **استيراد السجلات**
3. قم بتنزيل ملف القالب للتأكد من أن بياناتك بالتنسيق المتوقع
4. ارفع ملف CSV المُنسَّق الخاص بك
5. طابِق أعمدتك مع حقول Twenty
6. راجِع الأخطاء (المظلَّلة باللون الأصفر) وأصلحها من خلال التحرير مباشرةً في واجهة المستخدم
7. أكد الاستيراد
### استيراد العلاقات بين الكائنات
يمكنك استيراد العلاقات بين الكائنات باستخدام وظيفة استيراد CSV. تحتاج إلى الإشارة إلى الجسم المرتبط باستخدام حقل فريد من هذا الجسم: `id`، و`email` للأشخاص وأعضاء مساحة العمل، و`domain` للشركات، وأي حقل آخر مُعيَّن كفريد في نموذج البيانات لأي جسم آخر.
<Note>**تُحتسب السجلات المحذوفة ضمن التفرّد.** السجلات المحذوفة حذفاً ناعماً (المرئية ضمن قائمة الأوامر → عرض السجلات المحذوفة) تُدرج ضمن عمليات التحقق من التفرّد. إذا قمتَ باستيراد سجل بالقيمة الفريدة نفسها لسجل محذوف، فسيتم استعادة السجل المحذوف.</Note>
<Warning>
**ترتيب الاستيراد مهم!**
عند استيراد أجسام مترابطة، ارفع الملفات بهذا الترتيب:
1. **الشركات** أولاً (جانب "الواحد" من العلاقات)
2. **الأشخاص** ثانيًا (مرتبطون بالشركات عبر companyId)
3. **الفرص** ثالثًا (مرتبطة بالشركات/الأشخاص)
4. **الأجسام المخصّصة** ذات العلاقات أخيراً
لماذا؟ يجب أن يكون جانب "الواحد" من علاقة واحد إلى متعدد موجودًا قبل أن تتمكن من الإشارة إليه. على سبيل المثال، يجب أن يكون سجل الشركة موجودًا قبل أن تستورد شخصًا يحمل معرّف تلك الشركة.
</Warning>
يرجى الرجوع إلى [هذه المقالة](/l/ar/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) للاطلاع على دليل خطوة بخطوة حول كيفية المتابعة.
## تصدير البيانات
صدّر بيانات مساحة العمل للنسخ الاحتياطي أو إعداد التقارير أو الترحيل.
### الخطوات
1. انتقل إلى الجسم الذي تريد تصديره
2. قم بتهيئة العرض بالأعمدة التي تحتاجها
3. انقر **⋮** → **تصدير العرض**
4. احفظ ملف CSV
<Note>**يتم تصدير الأعمدة المرئية فقط.** سيحتوي ملف CSV فقط على الأعمدة المعروضة في عرضك الحالي. أضِف الأعمدة أو أخفها قبل التصدير للتحكم في البيانات المُدرجة.</Note>
<Note>**حدود التصدير**: حتى 20,000 سجل لكل عملية تصدير.</Note>
## الصلاحيات
يتطلّب استيراد وتصدير البيانات أذونات محددة:
* **الاستيراد**: يتطلب إذن "Import CSV"
* **التصدير**: يتطلب إذن "Export CSV"
تواصل مع مسؤول مساحة العمل لديك إذا لم تكن تملك هذه الأذونات.
## الخطوات التالية
* [حضّر ملفات CSV الخاصة بك](/l/ar/user-guide/data-migration/how-tos/prepare-your-csv-files)
* [استيراد العلاقات بين الأجسام](/l/ar/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
* [الاستيراد عبر API لمجموعات البيانات الكبيرة](/l/ar/user-guide/data-migration/how-tos/import-data-via-api)

View File

@@ -0,0 +1,122 @@
---
title: الحقول
description: فهم دور الحقول وكيفية إدارتها.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## حول الحقول
الحقول مثل الأعمدة في جدول البيانات. تُخزّن أنواعًا مختلفة من البيانات مثل النصوص أو الأرقام أو التواريخ. يمكن أن تكون الحقول قياسية (مدمجة) أو مخصصة (التي تقوم بإنشائها).
### الحقول القياسية
الحقول القياسية تأتي مدمجة في Twenty للتعامل مع احتياجات الأعمال العامة.
على سبيل المثال، `الاسم الأول` و`الاسم الأخير` هما حقول قياسية في كائن `الأشخاص`. تخزن البيانات النصية للأسماء الفردية.
لا يمكنك حذف الحقول القياسية، ولكن يمكنك إلغاء تنشيطها إذا لم تكن بحاجة إليها.
يمكنك أيضًا تخصيص خيارات الحقول القياسية من نوع `SELECT`، على سبيل المثال خيارات `Stage` في الفرص.
<img src="/images/user-guide/fields/standard-fields.png" style={{width:'100%'}} />
### الحقول المخصصة
يمكن إضافة الحقول المخصصة إلى أي كائن. يمكنك تخزين النصوص أو الأرقام أو التواريخ أو الخيارات المنسدلة والمزيد. استخدم الحقول المخصصة لتتبع المعلومات الخاصة بأعمالك.
على سبيل المثال، الحقل المخصص لـ SpaceX يمكن أن يكون `حالة الصاروخ النشطة`، مما يشير إلى ما إذا كان الصاروخ يعمل.
<img src="/images/user-guide/fields/custom-fields.png" style={{width:'100%'}} />
## أنواع الحقول
يدعم Twenty أنواعًا متعددة من الحقول:
| النوع | الوصف | مثال |
| ----------------- | ----------------------------------------------------------------- | --------------------------- |
| العنوان | عنوان مُهيكل يتضمن الشارع، المدينة، الولاية، البلد، الرمز البريدي | عنوان المكتب |
| مصفوفة | قائمة بقيم نصية | الوسوم |
| قيمة منطقية | خانة اختيار صح/خطأ | نشط |
| العملة | قيمة نقدية مع رمز العملة | مبلغ الصفقة (USD) |
| تاريخ | قيم التاريخ | تاريخ الإغلاق |
| التاريخ والوقت | تاريخ مع الوقت | وقت الاجتماع |
| النطاق | نطاق موقع الويب (يُستخدم للشركات) | acme.com |
| البريد الإلكتروني | عناوين البريد الإلكتروني (مع الأساسي + الإضافي) | بريد جهة الاتصال الإلكتروني |
| JSON | بيانات JSON مُهيكلة | بيانات وصفية مخصصة |
| روابط | عناوين URL مع تسميات (أساسي + ثانوي) | موقع الويب، لينكدإن |
| نص طويل | نص متعدد الأسطر | الوصف، الملاحظات |
| التحديد المتعدد | خيارات متعددة من قائمة محددة مسبقًا | وسوم، فئات |
| رقم | قيم رقمية (صحيحة أو عشرية) | الكمية، الدرجة |
| هاتف | أرقام هواتف مع رمز البلد | هاتف العمل |
| تقييم | تقييم بالنجوم (1-5) | الأولوية، الدرجة |
| علاقة | روابط إلى السجلات في كائنات أخرى | الشركة → الأشخاص |
| اختيار | خيار واحد من قائمة محددة مسبقًا | المرحلة، الحالة |
| نص | سطر واحد من النص | الاسم، العنوان |
## إنشاء حقل مخصص
لإضافة حقل مخصص لأي كائن، اتبع هذه الخطوات:
1. اذهب إلى `الإعدادات` في الشريط الجانبي الأيسر.
2. اذهب إلى `نموذج البيانات`، ثم حدد الكائن الذي ترغب في تخصيصه.
3. تقدم من خلال النقر على `+ حقل جديد`.
4. اختر اسم الحقل والنوع الذي يناسب احتياجاتك. فكر في إضافة وصف للحقل لفهم أفضل.
أصبح الحقل الجديد الذي أنشأته الآن متاحًا ضمن حقول التطبيق. لعرضه في عرض محدد، انقر على قائمة الخيارات، ثم اختر `الحقول`.
<VimeoEmbed videoId="927628219" title="عرض توضيحي بالفيديو" />
**طريقة سريعة:** اضغط على زر **+** في أعلى يمين أي جدول كائن، ثم اختر `تخصيص الحقول`. سيأخذك هذا مباشرة إلى إعدادات نموذج البيانات.
<img src="/images/user-guide/fields/quick-new-field.png" style={{width:'100%'}} />
## إلغاء تنشيط حقل
يمكنك إلغاء تنشيط حقل لإخفائه من التطبيق دون فقدان بياناتك. اعتبره كإخفاء للحقل بدلاً من حذفه.
إليك كيفية القيام بذلك:
1. ابحث عن الحقل الذي تريد إلغاء تنشيطه في إعدادات الكائن الخاصة بك.
2. انقر على الثلاث نقاط `⋮` بجانب الحقل لفتح القائمة.
3. اختر `إلغاء التنشيط` من القائمة المنسدلة.
<img src="/images/user-guide/fields/deactivate-field.png" style={{width:'100%'}} />
ماذا يحدث عند إلغاء تنشيط حقل؟
1. **في التطبيق:** يختفي الحقل ولا يمكنك إضافة قيم جديدة إليه.
2. **العلاقات الموجودة:** إذا كان حقل علاقة، ستبقى الروابط القائمة ولكن لا يمكنك إنشاء روابط جديدة.
3. **الوصول عبر API:** لا يزال بإمكانك الوصول إلى الحقل وبياناته عبر API.
يمكنك إعادة تنشيط الحقول القياسية والمخصصة أو لديك خيار حذفها نهائيًا.
## جعل الحقول فريدة
اجعل الحقل فريدًا لضمان عدم إمكانية أن تحتوي السجلات المميزة على نفس القيمة. على سبيل المثال، عناوين البريد الإلكتروني فريدة لكل شخص.
إذا ظهرت لك رسالة خطأ عند تعيين خاصية التفرد، فتحقق من وجود قيم مكررة في بياناتك (بما في ذلك السجلات المحذوفة).
## الفهارس (متقدّم)
تُدار فهارس قاعدة البيانات تلقائيًا — ونادرًا ما تكون إضافة فهارسك الخاصة ضرورية، ومن السهل الوقوع في الأخطاء عند القيام بذلك. مع تفعيل الوضع المتقدّم، يكون لكل كائن قسم **Indexes** تحت `Settings → Data Model → <object>` للحالات التي تعلم فيها أنك بحاجة إلى فهرس.
## أفضل ممارسات تكوين الحقول
### اتفاقيات التسمية والقيود
* **يجب أن تكون الأسماء المفردة والجمع مختلفة**: يحتاج GraphQL API الخاص بنا إلى أسماء مميزة لعمليات التعديل
* **أسماء الحقول المحمية**: بعض الأسماء محجوزة للاستخدام الخاص بالنظام (مثل `Type`، `Application`)
### حقول العملة والهاتف
* **العملة الافتراضية**: يمكن تهيئتها عبر نموذج البيانات
* **أكواد الدول الافتراضية**: يمكن تهيئتها لحقول الهاتف عبر نموذج البيانات
### حقول الاختيار
* **يمكن اختيار خيار افتراضي** لكل حقل اختيار
### حقول نص السجلات
* **كل كائن لديه حقل عرض رئيسي واحد**: يظهر هذا الحقل في العمود الأول ويمثل السجل عند الربط بأشياء أخرى. يجب أن يكون حقل نصي. على سبيل المثال، يستخدم الأشخاص `الاسم` كحقل رئيسي، لذلك عندما تربط شخصًا بشركة، سترى اسمهم في عرض الشركة.

View File

@@ -0,0 +1,92 @@
---
title: كائنات
description: تعرّف على الكائنات القياسية والمخصصة في Twenty.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## الكائنات القياسية
الكائنات القياسية هي كيانات مُعرّفة مسبقًا في مساحة العمل الخاصة بك لمساعدتك في البدء. هي جزء من نموذج بيانات مشترك يمكن الوصول إليه بواسطة جميع مستخدمي Twenty. يمكنك استخدامها كما هي أو تخصيصها أو تعطيلها.
<img src="/images/user-guide/objects/standard-objects.png" style={{width:'100%'}} />
### الأشخاص
كائن "الأشخاص" يخزن جهات الاتصال الخاصة بك. يتضمن تفاصيل الاتصال وتاريخ التفاعل، مما يتيح لك رؤية جميع تفاعلات العملاء في مكان واحد.
### الشركات
كائن "الشركات" يخزن المعلومات المتعلقة بحسابات العمل الخاصة بك. يتضمن تفاصيل مثل الصناعة والحجم والموقع. الشركات تتصل بكائنات "الأشخاص" و "الفرص".
### الفرص
كائن "الفرص" يخزن البيانات المتعلقة بالصفقات. يتتبع تقدم المبيعات المحتملة من البداية إلى الإغلاق، مع تسجيل المراحل، أحجام الصفقات، الحساب المرتبط، وتاريخ الإغلاق المتوقع. يمكنك عرض مسار المبيعات الخاص بك في تخطيط كانبان.
### الملاحظات
يخزّن كائن `Notes` ملاحظات حرة يمكن إرفاقها بالأشخاص والشركات والفرص وسجلات أخرى. استخدم الملاحظات لالتقاط ملخصات الاجتماعات والتفاصيل المهمة أو أي معلومات سياقية.
### المهام
يخزّن كائن `Tasks` المهام المطلوب إنجازها وبنود العمل. يمكن ربط المهام بالأشخاص والشركات والفرص وسجلات أخرى. تتبّع تواريخ الاستحقاق والمكلّفين وحالة الإكمال للبقاء على اطّلاع بمتابعاتك.
## كائنات مخصصة
تتيح لك الكائنات المخصصة تخزين المعلومات الفريدة لمنظمتك والتي لا يمكن للكائنات القياسية التعامل معها. على سبيل المثال، إذا كنت SpaceX، قد ترغب في إنشاء كائن مخصص للصواريخ والإطلاقات.
<img src="/images/user-guide/objects/custom-objects.png" style={{width:'100%'}} />
### إنشاء كائن مخصص جديد
لإنشاء كائن مخصص جديد:
1. اذهب إلى الإعدادات في الشريط الجانبي الأيسر.
2. تحت مساحة العمل، انتقل إلى نموذج البيانات. هنا ستتمكن من رؤية نظرة عامة على جميع الكائنات المعيارية والمخصصة الموجودة (نشطة وغير مفعلة).
<VimeoEmbed videoId="926288174" title="عرض توضيحي بالفيديو" />
3. انقر على "+ كائن جديد" في الأعلى. أدخل الاسم (مفرد وجمع)، اختر أيقونة، أضف وصفًا للكائن المخصص واضغط حفظ (في الزاوية العليا اليمنى). باستخدام القائمة كمثال للكائن المخصص، سيكون المفرد هو "قائمة" والجمع "قوائم" مع الوصف كمثل "قوائم قام المضيفون بإنشائها لعرض ممتلكاتهم."
4. تم الآن إنشاء الكائن المخصص الخاص بك وسيظهر في الشريط الجانبي لديك. يمكنك البدء في إضافة السجلات إليه فورًا.
## إدارة الكائنات
### إلغاء تنشيط الكائنات
إذا لم تكن بحاجة إلى كائن قياسي أو مخصص:
1. انتقل إلى الإعدادات → نموذج البيانات
2. العثور على الكائن الذي تريد إلغاء تفعيله والنقر عليه
3. اذهب إلى تبويب **إعدادات** الكائن
4. انقر فوق زر "إلغاء التفعيل"
5. سيتم إخفاء الكائن من مساحة العمل لديك ولكن سيتم الاحتفاظ بالبيانات
### إعادة تنشيط الكائنات
لإعادة كائن تم إلغاء تنشيطه:
1. انتقل إلى الإعدادات → نموذج البيانات
2. تمكين فلتر "معطل"
3. ابحث عن الكائنات المعطلة (لديهم 'تعطيل' بجانب اسمه)
4. انقر على `⋮` ثم `Activate` لإعادة تنشيطه
5. سيتم استعادة الكائن وجميع بياناته
## أفضل الممارسات
### متى يجب إنشاء كائنات مخصصة
* **كيانات عمل فريدة**: أمور خاصة بمجالك أو بعملياتك
* **علاقات معقّدة**: عندما تحتاج إلى تتبّع الروابط بين عدة كيانات
* **بيانات قابلة للتوسّع**: عندما قد يكون لديك العديد من المثيلات لشيء ما
### متى تستخدم الحقول بدلًا من ذلك
* **سمات بسيطة**: خصائص تصف الكائنات الموجودة
* **فئات أو تسميات**: طرق لتصنيف السجلات الموجودة
* **قيم مفردة**: معلومات لا تحتاج إلى دورة حياة خاصة بها
### تسمية الكائنات
* **استخدم أسماء واضحة ووصفية**: اجعل ما يمثّله الكائن واضحًا
* **اتّبع الاصطلاحات**: استخدم المفرد لاسم الكائن، والجمع للمجموعة
* **ضع فريقك في الاعتبار**: اختر أسماء يفهمها الجميع

View File

@@ -0,0 +1,94 @@
---
title: حقول العلاقات
description: اربط السجلات عبر كائنات مختلفة باستخدام حقول العلاقة.
---
## أنواع العلاقات
### واحد-إلى-متعدد
يمكن ربط سجل واحد في الكائن A بالعديد من السجلات في الكائن B.
**مثال:** يمكن أن يكون لدى شركة واحدة العديد من الأشخاص (الموظفين).
### متعدد-إلى-واحد
يمكن ربط سجلات متعددة في الكائن A بسجل واحد في الكائن B.
**مثال:** يمكن أن ينتمي العديد من الأشخاص إلى شركة واحدة.
### العلاقات إلى أنواع كائنات متعددة
يمكن لبعض الكائنات الارتباط بأنواع كائنات متعددة على جانب واحد من العلاقة.
**مثال:** يمكن إرفاق ملاحظة بشخص واحد وشركة واحدة وفرصة واحدة في الوقت نفسه. الملاحظة على جانب "العديد"، وتتصل بعدة جوانب "الواحد".
<img src="/images/user-guide/fields/many-to-one-morph.png" style={{width:'100%'}} />
وبالمثل، يمكن لمشروع (على جانب "الواحد") أن يتلقى روابط من عدة أشخاص، وعدة شركات، وعدة ملاحظات.
<img src="/images/user-guide/fields/one-to-many-morph.png" style={{width:'100%'}} />
<Warning>
**قيد الاستيراد/التصدير**: العلاقات التي تشير إلى أنواع كائنات متعددة غير مدعومة بعد لاستيراد/تصدير CSV. هذا على خارطة الطريق لدينا.
</Warning>
### متعدد-إلى-متعدد
يمكن ربط سجلات متعددة في الكائن A بسجلات متعددة في الكائن B.
**مثال:** يمكن ربط العديد من الأشخاص بالعديد من المشاريع، والعكس صحيح.
تستخدم العلاقات من نوع متعدد إلى متعدد نمط **كائن ربط**: كائن وسيط يربط بين الجانبين. باستخدام ميزة علاقة الربط، تعرض Twenty السجلات المرتبطة النهائية مباشرةً، مع إخفاء الكائن الوسيط من واجهة المستخدم.
<Warning>
**ميزة بيتا**: يجب تمكين علاقات الباقة في **الإعدادات → مجتمع الميزات** قبل الاستخدام.
</Warning>
راجع [كيفية إنشاء علاقات متعدد-إلى-متعدد](/l/ar/user-guide/data-model/how-tos/create-many-to-many-relations) للحصول على دليل كامل خطوة بخطوة.
## إنشاء حقل علاقة
1. اذهب إلى **الإعدادات → نموذج البيانات**
2. حدد الكائن الذي تريد إضافة العلاقة إليه
3. انقر فوق **+ حقل جديد**
4. اختر **العلاقة** كنوع الحقل
5. اختر الكائن(ات) الهدف للربط بها
6. كوّن إعدادات العلاقة:
* **اسم الحقل على الكائن المصدر**: اسم حقل العلاقة على الكائن الذي تقوم بتحريره
* **اسم الحقل على كائن الوجهة**: اسم حقل العلاقة الذي سيظهر على الكائن الهدف
* نوع العلاقة (واحد-إلى-متعدد، متعدد-إلى-واحد)
7. انقر على **حفظ**
## العلاقات القياسية
تأتي Twenty بعلاقات مبنية مسبقًا بين الكائنات القياسية:
| من الكائن | إلى الكائن | نوع العلاقة |
| --------- | ---------- | -------------- |
| الأشخاص | الشركات | متعدد-إلى-واحد |
| الفرص | الشركات | متعدد-إلى-واحد |
| الفرص | الأشخاص | متعدد-إلى-واحد |
## أفضل الممارسات
### تخطيط العلاقات
* **ارسم خريطة نموذج البيانات**: خطط للعلاقات قبل إنشائها
* **ضع الاتجاه في الاعتبار**: فكّر في الكائن الذي "يمتلك" العلاقة
* **تجنّب الاعتماديات الدائرية**: حافظ على نظافة نموذج بياناتك
### تسمية العلاقات
* **استخدم أسماء واضحة**: اجعل ما تمثّله العلاقة واضحًا
* **كن متسقًا**: استخدم أنماط تسمية متشابهة عبر العلاقات
* **ضع كلا الجانبين في الاعتبار**: قم بتسمية كلا جانبي العلاقة بشكل مناسب
### الأداء
* **لا تفرط في إنشاء العلاقات**: كثرة العلاقات قد تبطئ مساحة عملك
## القيود
* **حذف العلاقات** يزيل الرابط لكنه لا يزيل السجلات المرتبطة
* **العلاقات الدائرية** ينبغي تجنبها للحفاظ على سلامة البيانات

View File

@@ -0,0 +1,72 @@
---
title: إنشاء حقول مخصصة
description: دليل خطوة بخطوة لإضافة حقول مخصصة إلى أي كائن.
---
تمكّنك الحقول المخصصة من جمع المعلومات الخاصة بنشاطك التجاري. أضفها إلى أي كائن—قياسي أو مخصص.
## الخطوات
1. اذهب إلى **الإعدادات → نموذج البيانات**
2. حدد الكائن الذي تريد إضافة حقل إليه
3. انقر فوق **+ حقل جديد**
4. اختر **نوع الحقل** (راجع [الحقول](/l/ar/user-guide/data-model/capabilities/fields) للاطلاع على جميع الأنواع)
5. أدخل **اسم الحقل** ووصفًا اختياريًا
6. قم بتهيئة الإعدادات الخاصة بالحقل (انظر أدناه)
7. انقر على **حفظ**
**طريقة سريعة:** انقر **+** في نهاية عناوين الأعمدة في أي عرض جدولي → **تخصيص الحقول**.
## إظهار الحقل في العروض
لا تظهر الحقول الجديدة تلقائيًا. للعرض:
1. افتح العرض الجدولي للكائن
2. انقر على **الخيارات → الحقول**
3. انقر على **أيقونة العين** بجانب الحقل لإظهاره
4. اسحب لإعادة الترتيب
## خيارات التهيئة
### لحقول الاختيار/الاختيار المتعدد
1. انقر **+ إضافة خيار** لإنشاء خيارات
2. عيّن **الخيار الافتراضي** إذا رغبت
3. اسحب لإعادة ترتيب الخيارات
<Note>
**استخدم أسماء واجهة برمجة التطبيقات (API) لعمليات الاستيراد.** فعّل **الوضع المتقدم** في الإعدادات لعرض أسماء واجهة برمجة التطبيقات. راجع [تعيين الحقول](/l/ar/user-guide/data-migration/capabilities/field-mapping).
</Note>
### لحقول العملة
عيّن **العملة الافتراضية** (USD وEUR وما إلى ذلك) للسجلات الجديدة.
### لحقول الهاتف
عيّن **رمز البلد الافتراضي** ليتم ملؤه مسبقًا للأرقام الهاتفية الجديدة.
### جعل الحقل فريدًا
فعّل **فريد** لمنع تكرار القيم عبر السجلات.
<Note>
إذا وُجدت قيم مكررة (بما في ذلك في السجلات المحذوفة)، ستظهر رسالة خطأ. أزل التكرارات أولًا.
</Note>
### تعيين القيم الافتراضية
في حقول الاختيار، يمكنك تحديد الخيار الذي سيتم اختياره مسبقًا للسجلات الجديدة. في حقول خانة الاختيار، حدّد ما إذا كانت محددة أم غير محددة افتراضيًا.
## إلغاء تنشيط حقل
1. اذهب إلى **الإعدادات → نموذج البيانات**
2. اعثر على الحقل
3. انقر **⋮ → إلغاء التنشيط**
تظل البيانات محفوظة. يمكنك إعادة التنشيط أو الحذف نهائيًا لاحقًا.
## ذات صلة
* [الحقول](/l/ar/user-guide/data-model/capabilities/fields) — شرح جميع أنواع الحقول
* [الأسئلة الشائعة حول نموذج البيانات](/l/ar/user-guide/data-model/how-tos/data-model-faq) — أسئلة شائعة

View File

@@ -0,0 +1,51 @@
---
title: إنشاء كائنات مخصصة
description: دليل خطوة بخطوة لإنشاء كائنات مخصصة في Twenty.
---
تتيح لك الكائنات المخصصة تخزين معلومات فريدة لعملك لا تغطيها الكائنات القياسية. على سبيل المثال: المشاريع، المنتجات، التذاكر، أو القوائم.
<Note>
**لست متأكدًا مما إذا كنت بحاجة إلى كائن أم حقل؟** اطّلع على [فهم نموذج البيانات لديك](/l/ar/user-guide/data-model/overview) للحصول على إرشادات.
</Note>
## الخطوات
1. اذهب إلى **الإعدادات → نموذج البيانات**
2. انقر فوق **+ إضافة كائن**
3. املأ ما يلي:
* **الاسم المفرد** (مثل: "Listing")
* **الاسم بصيغة الجمع** (مثل: "Listings")
* **أيقونة**
* **الوصف** (اختياري)
4. انقر على **حفظ**
يظهر كائنك في الشريط الجانبي فورًا.
## التالي: إضافة الحقول
تبدأ الكائنات الجديدة بحقول أساسية. أضف حقولًا مخصصة لالتقاط البيانات التي تحتاج إليها:
1. في **الإعدادات → نموذج البيانات**، حدّد كائنك
2. انقر فوق **+ حقل جديد**
3. اختر نوع الحقل، قم بإعداده، ثم احفظ
اطّلع على [كيفية إنشاء حقول مخصصة](/l/ar/user-guide/data-model/how-tos/create-custom-fields) للحصول على تفاصيل حول أنواع الحقول والإعداد.
## الاتصال بكائنات أخرى
لربط كائنك بالأشخاص والشركات أو كائنات أخرى، أنشئ حقل علاقة. اطّلع على [كيفية إنشاء حقول العلاقات](/l/ar/user-guide/data-model/how-tos/create-relation-fields).
## إلغاء تنشيط كائن
إذا لم تعد بحاجة إلى كائن:
1. انتقل إلى **الإعدادات → موديل البيانات → كائن من اختيارك → الإعدادات**
2. انقر فوق زر **إلغاء التفعيل**
سيتم إخفاء الكائن ولكن سيتم الاحتفاظ بالبيانات. يمكنك إعادة تنشيطه أو حذفه نهائيًا لاحقًا.
## ذات صلة
* [الكائنات](/l/ar/user-guide/data-model/capabilities/objects) — الكائنات القياسية مقابل الكائنات المخصصة
* [الأسئلة الشائعة حول نموذج البيانات](/l/ar/user-guide/data-model/how-tos/data-model-faq) — أسئلة شائعة

View File

@@ -0,0 +1,175 @@
---
title: إنشاء علاقات متعدد-إلى-متعدد
description: اربط السجلات حيث يمكن ربط عناصر كثيرة على كلا الجانبين معًا باستخدام كائنات الربط.
---
تتيح علاقات متعدد-إلى-متعدد ربط سجلات متعددة على كلا الجانبين. على سبيل المثال: يمكن للعديد من الأشخاص العمل على العديد من المشاريع، ويمكن لكل مشروع أن يضم العديد من الأشخاص.
<Warning>
**ميزة تجريبية**: علاقات الربط حاليًا في المرحلة التجريبية. فعِّلها في **الإعدادات → المجتمع → الميزات** قبل اتباع هذا الدليل.
</Warning>
<Note>
تتطلب هذه الميزة أيضًا تفعيل **الوضع المتقدم** (زر التبديل في أسفل يسار صفحة الإعدادات).
</Note>
## متى نستخدم علاقات متعدد-إلى-متعدد
استخدم علاقات متعدد-إلى-متعدد عندما يمكن لكل جانب من العلاقة أن يحتوي على عدة ارتباطات:
| العلاقة | مثال |
| ------------------ | --------------------------------------------------------------------- |
| الأشخاص ↔ المشاريع | قد يعمل الشخص على عدة مشاريع؛ ويضم المشروع عدة أعضاء فريق |
| الشركات ↔ الوسوم | يمكن أن تحتوي الشركة على عدة وسوم؛ ويمكن أن ينطبق الوسم على عدة شركات |
| المنتجات ↔ الطلبات | يمكن أن يوجد المنتج في عدة طلبات؛ ويحتوي الطلب على عدة منتجات |
## كيف يعمل
تستخدم Twenty نمط **كائن الربط** لعلاقات متعدد-إلى-متعدد. يوضع كائن الربط بين كائنين ويحتفظ بالارتباطات:
```
People ←→ Project Assignments ←→ Projects
```
يحتوي كائن **تعيينات المشروع** (كائن ربط) على:
* علاقة مع الأشخاص (متعدد-إلى-واحد)
* علاقة مع المشاريع (متعدد-إلى-واحد)
عند تفعيل مفتاح علاقة الربط، تعرض Twenty السجلات المرتبطة مباشرةً بدلًا من إظهار سجلات كائن الربط الوسيطة.
## المتطلبات الأساسية
1. **تفعيل علاقات الربط في الميزات التجريبية**: انتقل إلى **الإعدادات → المجتمع → الميزات** وفعِّل **علاقات الربط**
2. **فعِّل الوضع المتقدم**: شغِّل **الوضع المتقدم** من أسفل يسار الشريط الجانبي لصفحة الإعدادات
3. خطِّط نموذج البيانات الخاص بك:
* ما الكائنان اللذان ستربطهما؟
* ما الاسم الذي ينبغي أن يُطلق على كائن الربط؟
## الخطوة 1: إنشاء كائن الربط
أولًا، أنشئ الكائن الوسيط الذي سيحتفظ بالارتباطات.
1. اذهب إلى **الإعدادات → نموذج البيانات**
2. انقر فوق **+ إضافة كائن**
3. سمِّه تسمية وصفية (مثلًا: "تعيين مشروع"، "عضو فريق"، "طلب منتج")
4. فعِّل خيار "تخطي إنشاء حقل الاسم"
<img src="/images/user-guide/fields/new-pivot-object.png" alt="كائن ربط جديد" />
5. انقر على **حفظ**
<Tip>
**اتفاقية التسمية**: استخدم اسمًا يصف العلاقة، مثل "تعيين مشروع" أو "عضوية الفريق". هذا يجعل نموذج البيانات أسهل في الفهم.
</Tip>
## الخطوة 2: إنشاء علاقات بين الكائنات وكائن الربط
أضف حقول العلاقة من كلٍ من الكائنين لديك إلى كائن الربط.
### العلاقة الأولى (الكائن A → كائن الربط)
1. حدِّد الكائن الأول لديك في **الإعدادات → نموذج البيانات**
2. انقر **+ إضافة علاقة**
3. اختر كائن الربط (مثلًا، "تعيينات المشروع")
4. عيِّن نوع العلاقة إلى **واحد-إلى-متعدد** (يمكن لشخص واحد الارتباط بالعديد من التعيينات)
5. قم بتسمية الحقول:
* الحقل على الأشخاص: مثلًا، "تعيينات المشروع"
* الحقل على كائن الربط: مثلًا، "شخص"
6. انقر على **حفظ**
### العلاقة الثانية (الكائن B → كائن الربط)
1. حدِّد الكائن الثاني لديك في **الإعدادات → نموذج البيانات**
2. انقر **+ إضافة علاقة**
3. اختر كائن الربط (مثلًا، "تعيينات المشروع")
4. عيِّن نوع العلاقة إلى **واحد-إلى-متعدد** (يمكن لمشروع واحد الارتباط بالعديد من التعيينات)
5. فعّل **"هذه علاقة بكائن ربط"**
<img src="/images/user-guide/fields/junction-relation-toggle.png" style={{width:'100%'}} />
6. قم بتسمية الحقول:
* الحقل على كائن الربط: مثلًا، "مشروع"
* الحقل على المشاريع: مثلًا، "أعضاء الفريق"
7. انقر على **حفظ**
## الخطوة 3: ضبط عرض علاقة الربط
قم الآن بضبط كائنات المصدر لعرض السجلات المرتبطة مباشرةً، مع تجاوز كائن الربط الوسيط.
1. اذهب إلى **الإعدادات → نموذج البيانات**
2. اختر الكائن الأول (مثلًا، "الأشخاص")
3. اعثر على حقل العلاقة الذي يشير إلى كائن الربط (مثلًا، "تعيينات المشروع")
4. انقر لتحرير الحقل
5. فعّل **"هذه علاقة بكائن ربط"**
6. حدِّد **العلاقة الهدف** (مثلًا، "مشروع" — الحقل على كائن الربط الذي يشير إلى الجانب الآخر)
7. انقر على **حفظ**
## النتيجة
بعد التكوين:
* في سجل **شخص**، يعرض حقل "تعيينات المشروع" **المشاريع** مباشرةً (وليس سجلات التعيين)
* في سجل **مشروع**، يعرض حقل "أعضاء الفريق" **الأشخاص** مباشرةً
لا يزال كائن الربط موجودًا ويخزّن الارتباطات، لكن واجهة المستخدم تقدّم عرضًا أوضح لعلاقات متعدد-إلى-متعدد.
## مثال: الأشخاص ↔ المشاريع
إليك شرحًا كاملًا خطوة بخطوة:
### إنشاء كائن الربط
* الاسم: **تعيين مشروع**
* الوصف: "يربط الأشخاص بالمشاريع التي يعملون عليها"
### إضافة علاقات
1. **الأشخاص → تعيين مشروع**
* النوع: واحد-إلى-متعدد
* الحقل على الأشخاص: "تعيينات المشروع"
* الحقل على التعيين: "شخص"
2. **المشاريع → تعيين مشروع**
* النوع: واحد-إلى-متعدد
* الحقل على المشاريع: "أعضاء الفريق"
* الحقل على التعيين: "مشروع"
### ضبط عرض علاقة الربط
1. على كائن **الأشخاص**:
* حرِّر حقل "تعيينات المشروع"
* فعّل مفتاح الربط
* الهدف: "مشروع"
2. على كائن **المشاريع**:
* حرِّر حقل "أعضاء الفريق"
* فعّل مفتاح الربط
* الهدف: "شخص"
### استخدمه
* افتح سجل شخص → سترى مشاريعه مباشرةً
* افتح سجل مشروع → سترى أعضاء الفريق مباشرةً
* أنشئ ارتباطات جديدة من أي جانب
## إضافة بيانات إضافية إلى الارتباطات
نظرًا لأن كائن الربط كائن حقيقي، يمكنك إضافة حقول مخصصة لتخزين معلومات حول العلاقة:
* **الدور**: "مطوّر"، "مصمّم"، "مدير"
* **تاريخ البدء**: عندما ينضم الشخص إلى المشروع
* **الساعات المخصّصة**: عدد الساعات الأسبوعية على هذا المشروع
للوصول إلى هذه البيانات، انتقل إلى كائن الربط مباشرةً أو استعلم عنها عبر واجهة API.
## القيود
* **استيراد/تصدير CSV**: لا يُدعم استيراد علاقات متعدد-إلى-متعدد مباشرةً. بدلًا من ذلك، استورد السجلات إلى كائن الربط.
* **عوامل التصفية**: قد تكون خيارات التصفية حسب علاقات متعدد-إلى-متعدد محدودة.
## ذات صلة
* [حقول العلاقات](/l/ar/user-guide/data-model/capabilities/relation-fields) — شرح أنواع العلاقات
* [إنشاء كائنات مخصصة](/l/ar/user-guide/data-model/how-tos/create-custom-objects) — كيفية إنشاء الكائنات
* [إنشاء حقول العلاقات](/l/ar/user-guide/data-model/how-tos/create-relation-fields) — إعداد العلاقات الأساسي

View File

@@ -0,0 +1,70 @@
---
title: إنشاء حقول العلاقة
description: دليل خطوة بخطوة لربط الكائنات باستخدام حقول العلاقة.
---
تربط حقول العلاقة السجلات من كائنات مختلفة—على سبيل المثال، ربط الأشخاص بالشركات.
<Note>
**لا يمكن تغيير أسماء العلاقات بعد إنشائها** (إذ تؤثر في واجهة برمجة التطبيقات API). خطط لأسماء العلاقات بعناية.
</Note>
## قبل أن تبدأ
قرّر:
* ما الكائنات التي تقوم بربطها؟ (مثال: الأشخاص → الشركات)
* أيّهما جانب "الواحد"؟ (مثال: شركة)
* أيّهما جانب "المتعدد"؟ (مثال: الأشخاص — يعمل العديد من الأشخاص في شركة واحدة)
* ما الاسم الذي يجب أن يحمله الحقل في كل جانب؟
راجع [حقول العلاقة](/l/ar/user-guide/data-model/capabilities/relation-fields) لشرح أنواع العلاقات.
## الخطوات
1. اذهب إلى **الإعدادات → نموذج البيانات**
2. حدّد الكائن الذي تريد فيه العلاقة (عادةً جانب "المتعدد")
3. انقر **+ حقل جديد**
4. اختر **علاقة** كنوع الحقل
5. اختر **الكائن المستهدف**
6. اختر **واحد إلى متعدد** أو **متعدد إلى واحد**
7. أدخل أسماء الحقول ل**كلا الجانبين** من العلاقة
8. انقر على **حفظ**
## مثال: الأشخاص → الشركات
* اذهب إلى **الإعدادات → نموذج البيانات → الأشخاص**
* أضف حقل علاقة
* الهدف: **الشركات**
* النوع: **متعدد إلى واحد**
* الحقل في الأشخاص: **الشركة**
* الحقل في الشركات: **الموظفون**
يمكن الآن ربط كل شخص بشركة، وتعرض كل شركة موظفيها.
## إلغاء تنشيط علاقة
1. انتقل إلى **الإعدادات → موديل البيانات → كائن من اختيارك**
2. ابحث عن حقل العلاقة وانقر عليه
3. انقر على زر **إلغاء التنشيط**
تظل الروابط محفوظة لكنها مخفية. أعد التنشيط لاستعادتها.
<Note>
**إلغاء تنشيط علاقة لا يحذف السجلات.** تتم إزالة الرابط بينهما فقط.
</Note>
## حذف علاقة
1. انتقل إلى **الإعدادات → موديل البيانات → كائن من اختيارك**
2. ابحث عن حقل العلاقة وانقر عليه
3. انقر على زر **حذف**
<Note>
ينطبق فقط على العلاقات العرفية. ولا يمكن تعطيل العلاقات المعيارية إلا في حالات الطوارئ.
</Note>
## ذات صلة
* [حقول العلاقة](/l/ar/user-guide/data-model/capabilities/relation-fields) — الأنواع والقيود
* [كيفية استيراد العلاقات](/l/ar/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) — الاستيراد الدفعي للسجلات المرتبطة

View File

@@ -0,0 +1,22 @@
---
title: تخصيص نموذج البيانات الخاص بك
description: نظرة عامة على خيارات تخصيص نموذج البيانات.
---
نموذج بيانات Twenty قابل للتخصيص بالكامل. أنشئ كائنات وحقولًا وعلاقات لتناسب نشاطك التجاري.
## روابط سريعة
| أريد أن... | دليل |
| ------------------- | ---------------------------------------------------------------------------------- |
| إنشاء كائن جديد | [كيفية إنشاء كائنات مخصصة](/l/ar/user-guide/data-model/how-tos/create-custom-objects) |
| إضافة حقول إلى كائن | [كيفية إنشاء حقول مخصصة](/l/ar/user-guide/data-model/how-tos/create-custom-fields) |
| ربط الكائنات معًا | [كيفية إنشاء حقول العلاقات](/l/ar/user-guide/data-model/how-tos/create-relation-fields) |
## معرفة المزيد
* [فهم نموذج بياناتك](/l/ar/user-guide/data-model/overview) — مفاهيم أساسية ونصائح للتخطيط
* [الكائنات](/l/ar/user-guide/data-model/capabilities/objects) — الكائنات القياسية مقابل الكائنات المخصصة
* [الحقول](/l/ar/user-guide/data-model/capabilities/fields) — جميع أنواع الحقول
* [حقول العلاقات](/l/ar/user-guide/data-model/capabilities/relation-fields) — ربط الكائنات
* [الأسئلة الشائعة حول نموذج البيانات](/l/ar/user-guide/data-model/how-tos/data-model-faq) — أسئلة شائعة

View File

@@ -0,0 +1,157 @@
---
title: الأسئلة المتكررة حول نموذج البيانات
description: الأسئلة الشائعة حول نموذج بيانات Twenty.
---
## إدارة الكائنات
<AccordionGroup>
<Accordion title="هل يمكنني حذف كائن مخصص؟">
نعم، يمكن حذف الكائنات المخصصة. يمكنك أيضًا إلغاء تنشيطها أولًا، مما يخفي الكائن وبياناته من الواجهة مع الاحتفاظ بالبيانات.
</Accordion>
<Accordion title="هل يمكنني حذف الكائنات القياسية (الأشخاص، الشركات، إلخ)؟">
لا، لا يمكن حذف الكائنات القياسية. يمكنك فقط إلغاء تنشيطها، مما يخفيها من الواجهة مع الاحتفاظ بالبيانات.
</Accordion>
<Accordion title="كم عدد الكائنات المخصصة التي يمكنني إنشاؤها؟">
يمكنك إنشاء ما تشاء من الكائنات والحقول المخصصة — لن يتغير السعر.
</Accordion>
<Accordion title="هل يمكنني إعادة تسمية كائن قياسي؟">
يمكنك تغيير تسمية الكائنات القياسية (People وCompanies وOpportunities)، لكن لا يمكنك تغيير أسماء API الخاصة بها. أسماء API ثابتة لضمان الاتساق عبر جميع مساحات عمل Twenty.
</Accordion>
<Accordion title="هل يمكنني تغيير أيقونة الكائن؟">
نعم، يمكنك تغيير الأيقونة لكلٍ من الكائنات القياسية والمخصصة ضمن **الإعدادات → نموذج البيانات**.
</Accordion>
<Accordion title="هل يمكنني إعادة ترتيب الكائنات في شريط التنقل الأيسر؟">
ليس بعد. ترتيب الكائنات في التنقل ثابت حاليًا، ولكن هذه الميزة مخطط لها لإصدارات قادمة.
</Accordion>
<Accordion title="هل يمكنني إخفاء الكائنات من شريط التنقل الأيسر؟">
تظهر كل الكائنات النشطة في التنقل. يمكنك إلغاء تفعيل الكائنات التي لا تحتاجها تحت **الإعدادات → نموذج البيانات**.
</Accordion>
</AccordionGroup>
## قدرات الحقول
<AccordionGroup>
<Accordion title="هل يمكنني تغيير نوع الحقل بعد إنشائه؟">
لا، لا يمكن تغيير أنواع الحقول بعد إنشائها. إذا كنت بحاجة إلى نوع مختلف، فأنشئ حقلًا جديدًا بالنوع الصحيح، وانقل بياناتك، ثم عطّل الحقل القديم.
</Accordion>
<Accordion title="لماذا أحتاج إلى أسماء مفردة وجمع مختلفة؟">
تستخدم واجهة GraphQL كلا النموذجين لعمليات مختلفة:
* `createPerson` (مفرد) لأعمال سجلات فردية
* `createPeople` (جمع) للعمليات الجماعية
هذا يخلق قيودًا عندما تكون الأشكال المفردة والجمع متشابهة، ولكنه يحسن تجربة المطور.
</Accordion>
<Accordion title="لماذا يتم حماية بعض أسماء الحقول؟">
بعض أسماء الحقول مثل `Type` أو `Application` محجوزة لاستخدام النظام. اختر أسماء بديلة مثل `Category` أو `Classification` بدلاً من ذلك.
</Accordion>
<Accordion title="ماذا يحدث عند إلغاء تنشيط حقل؟">
* يتم إخفاء الحقل من الواجهة
* تظل البيانات محفوظة
* لا يزال بإمكانك الوصول إلى الحقل عبر API
* تظل العلاقات الحالية موجودة، ولكن لا يمكنك إنشاء علاقات جديدة
* يمكنك إعادة تنشيط الحقل لاحقًا
</Accordion>
<Accordion title="هل يمكنني جعل الحقل إلزاميًا؟">
حاليًا، لا يمكنك جعل الحقول المخصصة إلزامية. جميع الحقول تقبل القيم الفارغة. يمكنك استخدام سير العمل لفرض الحقول الإلزامية عبر إرسال التنبيهات أو حظر الإجراءات عندما تكون الحقول فارغة.
</Accordion>
<Accordion title="ما الفرق بين الفريد والإلزامي؟">
* **فريد**: يجب ألّا تتكرر القيمة نفسها في هذا الحقل عبر السجلات
* **إلزامي**: يجب أن يحتوي الحقل على قيمة (غير مدعوم حاليًا للحقول المخصصة)
</Accordion>
<Accordion title="هل يمكنني إنشاء حقول صيغة؟">
حقول الصيغة قادمة في **H2 2026**. في الوقت الحالي، يمكنك استخدام سير العمل لحساب وتحديث قيم الحقول تلقائيًا.
</Accordion>
<Accordion title="هل يمكن أن يكون لدي حقول متداخلة داخل الكائنات الخاصة بي؟">
الحقول المتداخلة قادمة في **H2 2026**. حاليًا، يمكنك استخدام سير العمل لإحضار قيم الحقول من الكائنات ذات الصلة. مثلاً، لعرض صناعة شركة على سجل شخص، قم بإنشاء حقل مخصص للأشخاص واستخدم سير العمل لمزامنة القيمة.
</Accordion>
<Accordion title="هل يمكنني إعادة ترتيب الحقول داخل الكائنات؟">
نعم، انتقل إلى الإعدادات → نموذج البيانات → كائن من اختيارك → تخطيط وانقر فوق **تخصيص صفحة التسجيل**. إذا تم تعطيل هذا الزر، يجب عليك إنشاء سجل.
</Accordion>
</AccordionGroup>
## العلاقات
<AccordionGroup>
<Accordion title="هل يمكنني إنشاء علاقة تشير إلى الكائن نفسه؟">
نعم! العلاقات ذاتية الإشارة مدعومة ومُوصى بها لحالات الاستخدام مثل التسلسلات الهرمية للحسابات. على سبيل المثال، أنشئ علاقة من Companies إلى Companies لتتبع حسابات الأصل/الفرع.
</Accordion>
<Accordion title="هل يمكنني إنشاء علاقات عديدة-إلى-عدة؟">
العديد من العلاقات تأتي في **H2 2026**. حاليًا، أنشئ كائنًا وسيطًا مع علاقتين واحد-إلى-عديد كحل بديل.
على سبيل المثال، لربط People وProjects (عديد-إلى-عديد)، أنشئ كائنًا باسم "Project Assignments" يحتوي على:
* علاقة إلى People (عديد من التعيينات → شخص واحد)
* علاقة إلى Projects (عديد من التعيينات → مشروع واحد)
</Accordion>
<Accordion title="ما هي العلاقات إلى أنواع كائنات متعددة (علاقات Morph)؟">
تتيح هذه أن يرتبط كائن واحد بأنواع كائنات متعددة مختلفة عبر حقل واحد. على سبيل المثال، يمكن إرفاق Notes بـ People وCompanies وOpportunities في الوقت نفسه.
يرتبط كل Note بشخص واحد وشركة واحدة وفرصة واحدة في الوقت نفسه.
اعرف المزيد في [حقول العلاقات](/l/ar/user-guide/data-model/capabilities/relation-fields).
</Accordion>
<Accordion title="هل يمكنني إنشاء علاقات متعددة بين الكائنات نفسها؟">
نعم، يمكنك إنشاء علاقات متعددة بين الكائنين نفسيهما. على سبيل المثال، يمكن أن يكون لدى Company علاقتا "Primary Contact" و"Billing Contact" مع People.
</Accordion>
<Accordion title="ماذا يحدث للعلاقات عند حذف سجل؟">
عند حذف سجل، تتم إزالة رابط العلاقة من السجلات المرتبطة. السجلات المرتبطة نفسها لا تُحذف.
</Accordion>
<Accordion title="هل يمكنني إنشاء علاقات دائرية؟">
على الرغم من أنها ممكنة تقنيًا، يجب تجنّب العلاقات الدائرية (A → B → C → A) لأنها قد تسبب التباسًا ومشكلات محتملة في الأداء.
</Accordion>
</AccordionGroup>
## الوصول والصلاحيات
<AccordionGroup>
<Accordion title="أين يمكنني رؤية وتعديل نموذج البيانات الخاص بي؟">
انتقل إلى **الإعدادات → نموذج البيانات** لعرض جميع الكائنات والحقول الخاصة بك وتحريرها.
</Accordion>
<Accordion title="لماذا لا أستطيع رؤية نموذج البيانات تحت الإعدادات؟">
اتصل بمسؤول المساحة لديك. يكون الوصول إلى نموذج البيانات عادة محظورًا على المسؤولين فقط.
</Accordion>
</AccordionGroup>
## إدارة البيانات
<AccordionGroup>
<Accordion title="هل هناك حد لعدد السجلات التي يمكنني امتلاكها؟">
لا يوجد حد صارم لعدد السجلات. ومع ذلك، قد تؤثر مجموعات البيانات الكبيرة جدًا في الأداء في بعض طرق العرض. استخدم عوامل التصفية وطرق العرض لإدارة مجموعات البيانات الكبيرة بفعالية.
</Accordion>
<Accordion title="هل يمكنني استيراد بيانات إلى الكائنات المخصصة؟">
نعم، يمكنك استيراد بيانات CSV إلى أي كائن، بما في ذلك الكائنات المخصصة. تدعم عملية الاستيراد تعيين الحقول للحقول المخصصة. اطّلع على [كيفية إعداد ملفات CSV الخاصة بك](/l/ar/user-guide/data-migration/how-tos/prepare-your-csv-files).
</Accordion>
<Accordion title="هل يمكنني تصدير تكوين نموذج البيانات الخاص بي؟">
حاليًا، لا يوجد تصدير مدمج لتكوين نموذج البيانات. تواصل مع الدعم إذا كنت بحاجة إلى نقل نموذج البيانات بين مساحات العمل.
</Accordion>
<Accordion title="كم عدد الحقول التي يمكن أن يكون فيها كائن واحد؟">
الحد الأقصى لعدد الحقول التي يمكن أن يكون فيها كائن واحد هو 1600 حقل حسب حدود البريد، بما في ذلك الحقول الموجودة والمحذوفة. كن على علم بأن عشرين لن تصلح مساحة عملك إذا تم الوصول إلى الحد الأقصى البالغ 1600 حقلا كما أنها تقع تحت سياستنا للاستخدام العادل.
</Accordion>
</AccordionGroup>
## هل تحتاج إلى المزيد من المساعدة؟
اطّلع على [خدمات التنفيذ](/l/ar/user-guide/getting-started/capabilities/implementation-services) للحصول على مساعدة في تصميم نموذج بيانات معقّد.

View File

@@ -0,0 +1,177 @@
---
title: نموذج البيانات
description: تعرّف إلى نموذج البيانات وكيفية تصميم نموذج يناسب نشاطك التجاري.
---
## ما هو نموذج البيانات؟
نموذج البيانات هو الهيكل الذي يحدّد كيفية تنظيم المعلومات في نظام إدارة علاقات العملاء (CRM) لديك. فكّر فيه باعتباره **المخطط** لبيانات عملائك — تصمّمه مرة واحدة، ثم تملؤه ببياناتك الفعلية.
## المفاهيم الأساسية
### كائنات
**الكائنات** هي الفئات الرئيسية للبيانات في نظام إدارة علاقات العملاء (CRM) لديك. يمثّل كل كائن نوعًا من الأشياء التي تريد تتبّعها.
يوفّر Twenty كائنات قياسية:
* **الأشخاص** — أفراد (جهات اتصال، عملاء محتملون، شركاء)
* **الشركات** — مؤسسات
* **الفرص** — صفقات أو مبيعات
* **ملاحظات** - الملاحظات المرفقة بالسجلات
* **المهام** — عناصر قائمة المهام المرتبطة بالسجلات
يمكنك أيضًا إنشاء **كائنات مخصّصة** لأي شيء خاص بنشاطك التجاري (مثل: المشروعات، الاشتراكات، الأحداث).
### الحقول
**الحقول** هي الخصائص أو السمات التي تصف كل كائن. إنها تخزّن المعلومات الفعلية.
على سبيل المثال، يحتوي كائن **الأشخاص** على حقول مثل:
* الاسم
* البريد الإلكتروني
* هاتف
* المسمى الوظيفي
* الشركة (علاقة بكائن الشركات)
للحقول **أنواع** مختلفة: نص، رقم، تاريخ، اختيار، اختيار متعدد، علاقة، وغير ذلك. يمكنك إضافة حقول مخصّصة إلى أي كائن.
### السجلات
**السجلات** هي الإدخالات الفردية داخل الكائن — البيانات الفعلية التي تنشئها وتديرها.
على سبيل المثال:
* "John Smith" هو **سجل** في كائن الأشخاص
* "Acme Corp" هو **سجل** في كائن الشركات
**تشبيه:**
| مفهوم نموذج البيانات | تشبيه من الواقع |
| -------------------- | --------------------------------------- |
| **الكائنات** | أقسام في كتاب (الفئات) |
| **حقول** | أعمدة في جدول بيانات (الخصائص) |
| **السجلات** | صفوف في جدول بيانات (الإدخالات الفعلية) |
تصمّم نموذج البيانات (الكائنات + الحقول) مرة واحدة، ثم تنشئ العديد من السجلات ضمن تلك البنية.
## لماذا تخصّص نموذج البيانات الخاص بك؟
كل شركة تعمل بطريقة مختلفة. يعني تخصيص نموذج البيانات أنك تستطيع تكييف Twenty حول عملياتك بدلاً من فرض عملياتك داخل نظام جامد.
توفر Twenty مرونة كاملة:
* أنشئ عددًا من الكائنات المخصّصة بقدر ما تحتاج
* أضِف حقولًا مخصّصة غير محدودة
* لا يتغيّر السعر بناءً على التخصيص
## نصائح لتصميم نموذج البيانات الخاص بك
### 1. ابدأ بكائناتك الأساسية
حدّد المفاهيم الرئيسية التي تعمل بها. توفّر Twenty مسبقًا:
* **الأشخاص** — جهات الاتصال لديك
* **الشركات** — حساباتك
* **الفرص** — صفقاتك
فكّر فيما قد تحتاج إليه أيضًا:
* ستحتاج Stripe إلى كائن `Subscriptions`
* ستحتاج Airbnb إلى كائن `Trips`
* ستحتاج مُسرِّعة أعمال إلى كائن `Batches`
### ٢. استخدم الحقول للاختلافات، وليس كائنات جديدة
إذا كان الشيء مجرد سمة لكائن موجود، فاجعله **حقلًا**.
**استخدم الحقول من أجل:**
* الفئات والوسوم (مثل `Industry` للشركات)
* قيم الحالة (مثل `Stage` للفرص)
* السمات والخصائص
### ٣. أنشئ كائنًا عندما يكون قائمًا بذاته
إذا كان للمفهوم دورة حياة أو خصائص أو علاقات خاصة به، فهو يستحق كائنًا مستقلًا.
**أنشئ كائنًا من أجل:**
* **المشروعات** — لها مواعيد نهائية ومالكون ومهام
* **الاشتراكات** — تربط بين الشركات والمنتجات والفواتير
* **الأحداث** — تتضمن الحضور وإجراءات المتابعة
تتجاوز هذه الأشياء مجرد ما يمكن تضمينه في حقل واحد لأنها تحمل بياناتها وعلاقاتها الخاصة.
### 4. أنشئ كائنًا عندما تكون السجلات مفتوحة وغير محددة العدد
إذا كان بالإمكان ربط الشيء مراتٍ متعددة ولا تعرف عددها، فاستخدم كائنًا.
**نهج غير جيد:**
إنشاء حقول مثل `Product 1`، `Product 2`، `Product 3`...
**نهج جيد:**
أنشئ كائنًا `Products` واربطه بالسجلات. يسمح ذلك بدعم منتج واحد أو اثنين أو حتى مائة منتج دون تغيير نموذجك.
### 5. حافظ على البساطة أولًا
ابدأ بالحقول. انتقل إلى كائنات جديدة فقط عندما تشعر بالقيود:
* عدد كبير جدًا من الحقول في كائن واحد
* سجلات مكررة يجب أن تكون منفصلة
* علاقات لا تتلاءم بسلاسة
## ملاحظة خاصة على الأشخاص، والشركات، والفرص
<Warning>
**تعمل مزامنة البريد الإلكتروني والتقويم فقط مع الأشخاص والشركات والفرص.**
هذه هي الكائنات الوحيدة التي يمكنك من خلالها الوصول إلى رسائل البريد الإلكتروني والاجتماعات المتزامنة من علبة البريد/التقويم لديك. نوصي باستخدامها قدر الإمكان.
</Warning>
**أفضل الممارسات:**
* إذا كنت بحاجة إلى تصنيفات للأشخاص، فاستخدم الحقول (وليس كائنات جديدة)
* مثال: استخدم حقل `Person Type` بقيم "عميل محتمل" و"شريك" بدلاً من إنشاء كائنات منفصلة
* أنشئ **عروضًا** مختلفة من أجل التصفية: أحدها يعرض الشركاء، وآخر يعرض العملاء المحتملين
**لا بأس بوجود حقول لا تنطبق على كل سجل.** على سبيل المثال، حقل `Referral Link` على الأشخاص ينطبق فقط عندما يكون `Person Type = Partner`. أخفِ هذا الحقل من العروض التي لا تكون ذات صلة.
## أسئلة لتوجيه اختيارك
اسأل نفسك:
<Check>هل هذه مجرد خاصية لشيء لدي بالفعل، أم أنها تحتاج إلى خصائص خاصة بها؟</Check>
<Check>هل سأحتاج يومًا إلى تتبّع عدة منها لكل سجل، دون معرفة عددها؟</Check>
<Check>هل يرتبط هذا المفهوم بعدة كائنات مختلفة، وليس بواحد فقط؟</Check>
<Check>هل ستكون له دورة حياة خاصة به (مراحل، تواريخ بدء/انتهاء)؟</Check>
إذا كانت الإجابة "نعم" على واحد أو أكثر، فربما حان الوقت لإنشاء كائن جديد.
## الوصول إلى نموذج البيانات الخاص بك
1. انتقل إلى **الإعدادات** في الشريط الجانبي الأيسر
2. انقر على **نموذج البيانات**
3. اعرض جميع كائناتك (القياسية والمخصصة)
4. انقر على أي كائن لعرض حقوله وتحريرها
<Note>
**لا ترى نموذج البيانات ضمن الإعدادات؟**
يكون الوصول إلى نموذج البيانات عادةً مقصورًا على المسؤولين. تواصل مع مشرف مساحة العمل إذا كنت بحاجة إلى الوصول.
</Note>
## الخطوات التالية
بعد أن تخطّط لنموذج البيانات الخاص بك:
* [كيفية إنشاء كائنات مخصصة](/l/ar/user-guide/data-model/how-tos/create-custom-objects)
* [كيفية إنشاء حقول مخصصة](/l/ar/user-guide/data-model/how-tos/create-custom-fields)
* [كيفية إنشاء حقول العلاقات](/l/ar/user-guide/data-model/how-tos/create-relation-fields)
## هل تحتاج إلى مساعدة؟
<Tip>
هل تريد مساعدة في تصميم نموذج البيانات الخاص بك؟ [اعثر على عشرين شريكا معتمدا](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-data-model) لتصميم وبناء الكائنات والحقول والعلاقات الخاصة بك.
</Tip>

View File

@@ -0,0 +1,104 @@
---
title: مسرد المصطلحات
description: تعرّف على المصطلحات الأساسية المستخدمة في Twenty.
---
## واجهة برمجة التطبيقات
واجهة برمجة التطبيقات (API) تتيح لك ربط Twenty بأنظمة برمجية أخرى وبناء تكاملات مخصصة.
## التطبيقات
التطبيقات هي امتدادات مخصّصة مُنشأة على شكل شيفرة يمكنها تعريف نماذج البيانات والوظائف المنطقية. تمكّن المطورين من إنشاء تخصيصات قابلة لإعادة الاستخدام يمكن نشرها عبر مساحات عمل متعددة.
## إجراءات الكود
إجراءات الكود هي خطوات في سير العمل تتيح لك كتابة شيفرة JavaScript مخصصة لتحويل البيانات أو إجراء حسابات أو تنفيذ منطق معقد غير ممكن بالإجراءات المضمنة.
## قائمة الأوامر
قائمة الأوامر هي واجهة وصول سريع (تُفتح باستخدام `Cmd + K` على Mac و `Ctrl + K` على Windows) تتيح لك تنفيذ الإجراءات وإنشاء السجلات والتنقل بكفاءة في مساحة العمل الخاصة بك.
## الشركات والأشخاص
يتضمن نظام إدارة علاقات العملاء نوعين أساسيين من السجلات:
* تمثل `الشركة` عملاً تجارياً أو منظمة.
* `People` تمثل العملاء الحاليين والمحتملين لشركتك.
## الحقول المخصصة
الحقول المخصصة هي حقول بيانات تُنشئها لالتقاط معلومات خاصة باحتياجات وعمليات عملك.
## نموذج البيانات
نموذج البيانات هو الهيكل الذي يحدد كيفية تنظيم المعلومات في نظام إدارة علاقات العملاء الخاص بك، بما في ذلك الكائنات الموجودة وخصائصها وعلاقاتها معًا.
## المفضلات
المفضلات هي السجلات التي قمت بتحديدها للوصول السريع، وتظهر في الشريط الجانبي للتنقل الفوري للبيانات الهامة.
## الحقل
الحقل يشير إلى منطقة معينة يتم فيها تخزين بيانات محددة لكيان معين.
## مكرر
المكرر هو إجراء في سير العمل يتكرر عبر مصفوفة من العناصر، وينفذ الإجراءات اللاحقة لكل عنصر في القائمة.
## كانبان
الـ`كانبان` هو طريقة بصرية لمتابعة عمليات الأعمال باستخدام البطاقات والأعمدة. يمثّل كل عمود مرحلة في عمليتك (مثل: جديد، جارٍ، ربح، خسارة)، وتحرّك السجلات عبر هذه المراحل مع تقدّمها.
## كائن
الكائن هو هيكل بيانات يمثل نوعاً معيناً من الكيانات في نظام إدارة علاقات العملاء الخاص بك (مثل الأشخاص أو الشركات أو الفرص). يمكن أن تكون الكائنات قياسية (مدمجة) أو مخصصة (تم إنشاؤها بواسطتك).
## الفرص
الفرص في نظام Twenty لإدارة علاقات العملاء هي صفقات أو مبيعات محتملة مع الحسابات أو جهات الاتصال.
## السجل
السجل هو مثال على كائن، مثل حساب محدد أو جهة اتصال.
## حقول العلاقات
تُنشئ حقول العلاقات الروابط بين الكائنات المختلفة، مما يتيح لك ربط السجلات معًا (مثل ربط شخص بشركة).
## الحقول القياسية
الحقول القياسية هي حقول بيانات مدمجة تأتي مع الكائنات بشكل افتراضي وتوفر وظائف شائعة في جميع مساحات العمل.
## المهام
المهام في Twenty CRM هي أنشطة مُسندة تتعلق بجهات اتصال أو حسابات أو فرص.
## المشغلات
المشغلات هي نقطة البداية في سير العمل — الحدث أو الشرط الذي يبدأ الأتمتة. تشمل الأمثلة إنشاء السجلات، وتحديث السجلات، وخطافات الويب، أو الأوقات المجدولة.
## العروض
يمكنك تخصيص عرض سجلاتك باستخدام العروض، وتعيين عوامل تصفية مختلفة وتخطيطات وخيارات فرز لكل عرض.
## Upsert
Upsert هي عملية تجمع بين "update" و"insert" — فهي تحدّث سجلاً موجوداً إذا تم العثور على تطابق، أو تنشئ سجلاً جديداً إذا لم يوجد تطابق.
## الويب هوكس
الويب هوكس هي رسائل آلية ترسل من Twenty إلى تطبيقات أخرى عند حدوث أحداث معينة، مما يتيح مزامنة البيانات في الوقت الفعلي.
## سير العمل
مسارات العمل هي عمليات مؤتمتة تطلق إجراءات بناءً على شروط محددة، مما يساعدك على أتمتة المهام المتكررة والعمليات التجارية.
## مساحة العمل
`مساحة العمل` تمثل عادةً شركة تستخدم Twenty. تحتوي على جميع السجلات والبيانات التي تدخلها أنت وأعضاء فريقك إلى Twenty.
لها اسم نطاق واحد، وهو عادةً الاسم الذي تستخدمه شركتك لعناوين البريد الإلكتروني للموظفين.
## أعضاء مساحة العمل
أعضاء مساحة العمل هم مستخدمو Twenty من فريقك الذين لديهم حق الوصول إلى مساحة العمل الخاصة بك. يمكن تعيينهم كمالكين أو معينين للسجلات.

View File

@@ -0,0 +1,17 @@
---
title: خدمات التنفيذ
description: سواء كنت بحاجة إلى مساعدة في البدء أو إنشاء تخصيصات متقدمة، لدينا الحل.
---
## شركاء التنفيذ
تعاون مع شركاء Twenty المعتمدين للحصول على تخصيصات وعمليات تكامل متقدمة، ودعم مخصص لعملية التنفيذ.
<CardGroup cols={٢}>
<Card title="تصفح الشركاء المعتمدين" icon="magnifying-glass" href="https://twenty.com/partners/list?ref=docs-implementation-services">
اعثر على شريك وتواصل معه مباشرة — وقُم بالتصفية حسب المنطقة واللغة والخبرة.
</Card>
<Card title="احصل على مطابقة من Twenty" icon="envelope" href="mailto:contact@twenty.com">
أخبرنا بما تحتاجه وسنربطك بالشريك المناسب.
</Card>
</CardGroup>

View File

@@ -0,0 +1,42 @@
---
title: ما هو Twenty
description: Twenty هو نظام إدارة علاقات العملاء (CRM) مفتوح المصدر يوفّر لك اللبنات الأساسية لإنشاء ما يحتاجه عملك بدقة.
---
## الرؤية
إن إنشاء نظام إدارة عملاء جيد أمر صعب لأنه عمل توازن دقيق.
بالنسبة لكل عمل، تبدو المتطلبات واضحة، ولكن احتياجات الجميع مختلفة.
النتيجة هي نظام إدارة عملاء إما بسيط جداً أو يحاول أن يكون شاملاً ولكنه لا يبرع في شيء.
في البداية، يبدو Twenty مثل أنظمة إدارة العملاء الأخرى التي تعرفها: يمكنك تتبع الصفقات، تنظيم جهات الاتصال، وإدارة المهام والملاحظات.
**لكن ما يميزنا هو توجهنا نحو التوسع. نبني منصة مفتوحة توفر لك اللبنات الأساسية لحل مشاكل عملك الفريدة.**
نحن نعطي الأولوية للمبادئ العالمية والأنماط الشائعة على قوائم الميزات.
لا نحاول تقديم كل الإجابات، بل نُمَكن المستخدمين من إيجاد الحلول الأنسب لهم.
المصدر المفتوح هو أساس نهجنا، مما يضمن تطور Twenty مع مجتمعه، لصالح مجتمعه.
## الفوائد
**قابل للتخصيص:** صمم ليتناسب مع احتياجات عملك.
**يقوده المجتمع:** بني وصيانته بواسطة مجتمع مفتوح المصدر ضخم.
**فعال من حيث التكلفة:** لن تكون مقيداً بمزود لأنك دائماً تستطيع استضافة النظام بنفسك.
## الميزات الرئيسية
* **التقويم والبريد الإلكتروني:** قم بمزامنة صندوق بريدك وتقويمك لترى جميع الاتصالات على سجلاتك في نظام إدارة علاقات العملاء (CRM). [تعرف على المزيد](/l/ar/user-guide/calendar-emails/overview).
* **نموذج البيانات:** أنشئ كائنات وحقولاً مخصصة لتتوافق مع عمليات عملك الفريدة. [استكشف](/l/ar/user-guide/data-model/overview).
* **ترحيل البيانات:** استورد بياناتك وصدّرها عبر CSV أو API. [ابدأ](/l/ar/user-guide/data-migration/overview).
* **طرق العرض والمسارات:** نظّم بياناتك باستخدام طرق عرض الجدول، ولوحات كانبان، ومسارات المبيعات. [اكتشف](/l/ar/user-guide/views-pipelines/overview).
* **سير العمل:** قم بأتمتة عمليات عملك ودمجها مع الأدوات الخارجية. [أنشئ عمليات أتمتة](/l/ar/user-guide/workflows/overview).
* **الذكاء الاصطناعي:** عزِّز نظام إدارة علاقات العملاء لديك بميزات ووكلاء مدعومين بالذكاء الاصطناعي. [استكشف الذكاء الاصطناعي](/l/ar/user-guide/ai/overview).
* **لوحات التحكم:** تتبع الأداء باستخدام تقارير مخصصة وتصوّرات مرئية. [عرض لوحات التحكم](/l/ar/user-guide/dashboards/overview).
* **الأذونات والوصول:** تحكّم في مَن يمكنه عرض بياناتك وتحريرها وإدارتها باستخدام أذونات مستندة إلى الأدوار. [تكوين الوصول](/l/ar/user-guide/permissions-access/overview).
* **الملاحظات والمهام:** أنشئ ملاحظات ومهام مرتبطة بسجلاتك لتحسين التعاون.
* **واجهة برمجة التطبيقات والويب هوكس:** الاتصال بالتطبيقات الأخرى وإنشاء عمليات تكامل مخصصة. [ابدأ التكامل](/l/ar/developers/extend/api).
## انضم الآن
[سجل هنا](https://app.twenty.com) أو [كن مساهماً على GitHub](https://github.com/twentyhq/twenty).

View File

@@ -0,0 +1,77 @@
---
title: تهيئة مساحة عملك
description: كل شركة تعمل بطريقة مختلفة. ابدأ بهذه الخطوات الثلاث لتكييف Twenty وفق احتياجاتك.
---
<Note>**إنجاز سريع**: ابدأ بربط صندوق بريدك. يوفر لك ذلك قيمة فورية ويساعد فريقك على رؤية Twenty أثناء العمل من خلال البيانات الحقيقية. يمكنك القيام بذلك من خلال الإعدادات → الحسابات.</Note>
## 1. تخصيص نموذج البيانات الخاص بك
يقدم Twenty المرونة التي تحتاجها لتصميم نموذج البيانات الذي يدعم أعمالك اليومية بأفضل طريقة ممكنة.
قم بإنشاء كائنات وحقول من أي نوع، بما في ذلك العلاقات بين كائناتك المختلفة. يمكنك القيام بذلك من خلال الإعدادات ← نموذج البيانات.
إليك بعض النصائح:
* **أنت غير محدود في عدد الحقول المخصصة أو الكائنات المخصصة**. لن يؤدي إضافة الكائنات والحقول المخصصة إلى ترقية خطتك.
* **الأشخاص والشركات والفرص هي الكائنات الثلاثة التي يمكنك من خلالها الوصول إلى رسائل البريد الإلكتروني والاجتماعات المتزامنة من صندوق بريدك وتقويمك**. ننصح باستخدام هذه الخيارات بقدر الإمكان، مع إضافة الحقول لفرز سجلاتك عند الضرورة. إليك مثالاً:
* من الأفضل استخدام كائن الناس لآفاقك وشركاؤك، إنشاء حقل على كائن الناس المسمى ”نوع الشخص“، بدلاً من إنشاء كائن مخصص، لأنك لن تتمكن من الوصول إلى رسائل البريد الإلكتروني المتبادلة مع هذا الشخص من سجلات الشريك.
* قم بإنشاء وجهات نظر مختلفة في الأشخاص، واحدة لعرض الشركاء وأخرى لعرض العملاء المحتملين.
* لا يمكن أن يكون لشخصين نفس عنوان البريد الإلكتروني. لا يمكن أن يكون لشركتين نفس النطاق.
* يمكنك تعطيل الحقول والكائنات القياسية التي لا ترغب في استخدامها.
* يمكنك إخفاء الحقول من العروض: لا تتردد في إنشاء حقول؛ فلن تضطر إلى عرضها جميعاً.
اقرأ [هذه المقالة](/l/ar/user-guide/data-model/overview) لتعلم كيفية تصميم نموذج بياناتك.
## ٢. أدخل بياناتك
إدخال بياناتك الحالية في Twenty يمنح فريقك السياق من البداية.
### قم بتوصيل بريدك الإلكتروني
إذا لم تقم بذلك عند إنشاء مساحتك، قم بتوصيل حساب **Google أو Microsoft** تحت الإعدادات → الحسابات. هذا يسمح لـ Twenty بـ:
* استيراد رسائلك واجتماعاتك
* إنشاء جهات الاتصال تلقائيًا بناءً على التفاعلات (اختياري)
* الحفاظ على تاريخ الاتصالات واضحًا لفريقك
**تستخدم مقدم خدمة آخر؟**
يمكنك إضافة بريد آخر عبر SMTP أو تقويم آخر عبر CalDAV. اذهب إلى **الإعدادات → الحسابات** لإجراء التهيئة.
### استيراد البيانات عبر CSV
استخدم قائمة الأوامر (`Cmd + K` أو `Ctrl + K`) لاستيراد الأشخاص، الشركات، الفرص أو أي كائنات مخصصة عبر CSV.
**إرشادات رئيسية**:
* قم بتنزيل الملف النموذجي لفهم التنسيق المتوقع
* حدد كل ملف بـ 10 آلاف سجل
* أزل عناوين البريد الإلكتروني المكررة للأشخاص أو النطاقات المكررة للشركات
* راجع وقم بإصلاح الأخطاء (المميزة باللون الأصفر) قبل الاستيراد
اقرأ [هذه المقالة](/l/ar/user-guide/data-migration/overview) لمعرفة المزيد حول استيراد البيانات.
## ٣. قم بإنشاء منظر العرض الأول الخاص بك
إنشاء وجهات نظر مختلفة هو مفتاح لجعل البيانات قابلة للعمل من أجل فريقك.
إليك كيفية المتابعة:
* **إضافة أو إخفاء الأعمدة**
إدارة الحقول المرئية في عرض معين عن طريق النقر على الخيارات الحقول (من أعلى اليمين). يمكنك إظهار/إخفاء الحقول من هناك.
* **إعادة ترتيب الحقول**
إعادة ترتيب الحقول من عرض معين بالنقر على الخيارات الحقول (من أعلى اليمين). قم بالسحب والإفلات لإعادة ترتيب الحقول.
* **تصفية العرض الخاص بك**
قم بتضييق نطاق السجلات المعروضة باستخدام الفلاتر من الأعلى الأيمن.
* **فرز السجلات**
أعد ترتيب السجلات المعروضة باستخدام وظيفة الفرز من الأعلى الأيمن أو بالنقر مباشرة على اسم العمود.
* **اختر التخطيط**
يمكنك التبديل إلى تخطيط **Kanban** أو قائمة **مجموعة حسب**، طالما أن الكائن يحتوي على حقل اختيار من نوع `Stage` أو مشابه.
* **احفظ عرضك كمفضلة**
يمكنك القيام بذلك باستخدام القائمة المنسدلة التي تعرض العروض المختلفة.
## ماذا بعد؟
ابدأ في إنشاء الأتمتة باستخدام [عمليات العمل](/l/ar/user-guide/workflows/overview).

View File

@@ -0,0 +1,48 @@
---
title: إنشاء مساحة عمل
description: اتبع دليل خطوة بخطوة عن كيفية التسجيل في Twenty، اختيار خطة اشتراك، وإعداد حسابك.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## الخطوة 1: التسجيل
1. انتقل إلى [الاشتراك في Twenty](https://app.twenty.com).
2. اختر طريقة التسجيل المفضلة لديك:
* **متابعة باستخدام Google** للتسجيل بحساب جوجل.
* **متابعة باستخدام Microsoft** للتسجيل بحساب مايكروسوفت.
* أو، **متابعة باستخدام البريد الإلكتروني** لتسجيل البريد الإلكتروني.
<VimeoEmbed videoId="927066829" title="عرض توضيحي بالفيديو" />
## الخطوة 2: اختيار فترة التجربة
اختر بين فترتين للتجربة:
### 30 يومًا
مع بطاقة ائتمان
### 7 أيام
بدون بطاقة ائتمان
تشمل كلتا التجربتين:
* وصول كامل
* جهات اتصال غير محدودة
* تكامل البريد الإلكتروني
* كائنات مخصصة
* واجهة برمجة التطبيقات والويب هوك
يمكنك النقر على "تغيير الخطة" لاختيار خطة أو فترة فوترية مختلفة.
<img src="/images/user-guide/create-workspace/choose-plan.png" style={{width:'100%'}} />
## الخطوة 3: تأكيد الدفع وتهيئة الحساب
بعد الموافقة على الدفع عن طريق الشريط، يتم توجيهك لإنشاء مساحة العمل الخاصة بك والملف الشخصي للمستخدم. تذكر أنه يمكنك إلغاء اشتراكك في أي وقت.
## الدعم
للاستفسارات أو المساعدة، تواصل مع فريق الدعم المتخصص عبر [contact@twenty.com](mailto:contact@twenty.com) أو أرسل رسالة على [Discord](https://discord.gg/cx5n4Jzs57).

View File

@@ -0,0 +1,84 @@
---
title: التنقل في Twenty
description: احصل على لمحة سريعة عن كيفية التنقل في المنصة وأين تتخذ إجراءات مختلفة.
---
## التصميم الرئيسي
مركز الشاشة هو **المكان الذي تعيش فيه السجلات**: الناس، الشركات، الفرص، المهام، الملاحظات، لوحة المعلومات، سير العمل وأي كائن آخر قمت بإنشائه. هذا هو المكان الذي تجري فيه جميع الأعمال اليومية.
يمكنك **عرض أو تحرير أو حذف السجلات** من هناك، وكذلك **إنشاء عروض جديدة**.
<img src="/images/user-guide/home/main-layout.png" style={{width:'100%'}} />
## شريط التنقل
على الجانب الأيسر، من الأعلى إلى الأسفل، ستتمكن من:
* التبديل بين **مساحات العمل المختلفة** باستخدام القائمة المنسدلة أو إنشاء مساحة عمل جديدة
* استخدم **شريط البحث** (اضغط على `/` للتركيز عليه فوراً)
* افتح قسم **الإعدادات**
* لديك حق الوصول المباشر إلى **المشاهدات المفضلة**. المفضلة فريدة لكل مستخدم.
* التبديل بين الكائنات المختلفة
* **أنشئ عمليات أتمتة** باستخدام سير العمل
<img src="/images/user-guide/home/navigation-bar.png" style={{width:'100%'}} />
## قائمة الأوامر
قائمة الأوامر تمنحك **وصولاً سريعاً إلى الإجراءات** في Twenty. يمكنك الوصول إليها بطريقتين:
* **اختصار لوحة المفاتيح**: اضغط `Cmd + K` (Mac) أو `Ctrl + K` (Windows)
* **الماوس**: انقر على النقاط الثلاث في الزاوية العلوية اليمنى
من هناك، يمكنك:
* إنشاء سجلات جديدة
* **استيراد وتصدير البيانات عبر CSV**
* إنشاء عروض جديدة
* الوصول إلى السجلات المحذوفة (يدعم Twenty عمليات الحذف المنطقي والدائم)
* عرض اختصارات لوحة المفاتيح للوصول بسرعة إلى الكائنات في مساحة العمل الخاصة بك
<img src="/images/user-guide/home/command-menu.png" style={{width:'100%'}} />
## شريط البحث
شريط البحث يمكن الوصول إليه عبر قائمة الأوامر، في الجزء العلوي من شريط التنقل الخاص بك، أو بالضغط على '/' للتركيز عليه فورا. يعمل البحث عبر جميع الكائنات.
<img src="/images/user-guide/home/search-bar.png" style={{width:'100%'}} />
## اللوحة الجانبية
عند النقر على سجل، تظهر اللوحة الجانبية على اليمين. يوفّر لك هذا لمحة سريعة عن المعلومات الأساسية للسجل، دون نقلك إلى صفحة أخرى. من هناك، يمكنك أن تقرر إغلاق هذه النظرة العامة أو الحصول على معلومات إضافية حول هذا السجل، بالنقر على زر فتح
<img src="/images/user-guide/home/side-panel.png" style={{width:'100%'}} />
## العروض
كل كائن (مثل الفرص أو الأشخاص) يدعم عدة عروض. لست مقيداً بعدد معين من العروض لكل كائن.
استخدم القائمة المنسدلة في أعلى يسار التصميم الرئيسي للتبديل بين العروض المختلفة. على سبيل المثال:
* استخدم عرض كانبان لتتبع الفرص حسب المرحلة
* استخدم عرض Group By لإنشاء أقسام وتحسين الكفاءة
* استخدم عوامل التصفية للتركيز على سجلات محددة (مثل العملاء المحتملين الذين تم إنشاؤهم الأسبوع الماضي)
* احفظ العروض المفلترة لاستخدامها لاحقاً
* المشاهدات المفضلة للوصول السريع
<img src="/images/user-guide/home/view-menu.png" style={{width:'100%'}} />
إذا كنت جديدًا على العروض، فاقرأ [دليل العروض والمسارات](/l/ar/user-guide/views-pipelines/overview) لتتعلم كيفية إنشائها وتخصيصها.
## الإعدادات
افتح الإعدادات من أعلى اليسار للقيام بما يلي:
* **ربط حسابات البريد الإلكتروني والتقويم** لديك لتزامن سلس للبريد الإلكتروني والتقويم
* خصص **نموذج بياناتك**: أنشئ كائنات وحقولاً وعلاقات مخصصة
* **ادخل إلى بيئة API التجريبية وقم بتهيئة خطافات الويب**
* **إدارة أذونات المستخدم** وعناصر التحكم في الوصول إلى مساحة العمل
* دعوة أعضاء الفريق وإدارة أدوار المستخدم
* تعديل ملف التعريف الخاص بك وتفضيلات مساحة العمل
* تكوين الفوترة ومراقبة استخدام اعتمادات سير العمل
* اكتشف ومكّن الميزات القادمة (ضمن التحديثات → الوصول المبكر)
* **الوصول إلى الدعم** للتواصل عبر الدردشة المباشرة
* **افتح المستندات** لاستعراض دليل المستخدم ووثائق المطورين
<Note>إذا لم ترَ كل تلك الأقسام ضمن الإعدادات، فتواصل مع مسؤول مساحة العمل لديك — فبعض الأقسام لديها صلاحيات وصول مقيّدة.</Note>

View File

@@ -0,0 +1,59 @@
---
title: دليل المستخدم
description: مرحباً بك في دليل مستخدم Twenty، مصادرك للإعدادات المتقدمة وأفضل الممارسات.
---
import { CardTitle } from "/snippets/card-title.mdx"
<CardGroup cols={3}>
<Card href="/l/ar/user-guide/data-model/overview" img="/images/user-guide/halftone/data-model.png">
<CardTitle>نموذج البيانات</CardTitle>
خصّص نموذج بياناتك ليتوافق مع عمليات عملك.
</Card>
<Card href="/l/ar/user-guide/data-migration/overview" img="/images/user-guide/halftone/data-migration.png">
<CardTitle>ترحيل البيانات</CardTitle>
استورد بياناتك وصدّرها عبر CSV أو API.
</Card>
<Card href="/l/ar/user-guide/calendar-emails/overview" img="/images/user-guide/halftone/calendar-emails.png">
<CardTitle>التقويم والبريد الإلكتروني</CardTitle>
جمّع اجتماعات فريقك ورسائله الإلكترونية في مكان واحد.
</Card>
<Card href="/l/ar/user-guide/workflows/overview" img="/images/user-guide/halftone/workflows.png">
<CardTitle>سير العمل</CardTitle>
أتمتة العمليات والتكامل مع الأدوات الخارجية.
</Card>
<Card href="/l/ar/user-guide/ai/overview" img="/images/user-guide/halftone/ai.png">
<CardTitle>الذكاء الاصطناعي</CardTitle>
عزّز فريقك بوكلاء الذكاء الاصطناعي.
</Card>
<Card href="/l/ar/user-guide/layout/overview" img="/images/user-guide/halftone/layout.png">
<CardTitle>التخطيط</CardTitle>
التنقل وطرق العرض وتخصيص صفحة السجل.
</Card>
<Card href="/l/ar/user-guide/dashboards/overview" img="/images/user-guide/halftone/dashboards.png">
<CardTitle>لوحات التحكم</CardTitle>
رؤى في الوقت الفعلي لتتبّع الأداء.
</Card>
<Card href="/l/ar/user-guide/permissions-access/overview" img="/images/user-guide/halftone/permissions.png">
<CardTitle>الأذونات والوصول</CardTitle>
أدِر الأدوار والوصول إلى Twenty.
</Card>
<Card href="/l/ar/user-guide/billing/overview" img="/images/user-guide/halftone/billing.png">
<CardTitle>الفوترة</CardTitle>
تعرّف على كيفية عمل التسعير والفوترة في Twenty.
</Card>
<Card href="/l/ar/user-guide/settings/overview" img="/images/user-guide/halftone/settings.png">
<CardTitle>الإعدادات</CardTitle>
قم بتكوين تفضيلات مساحة العمل الخاصة بك.
</Card>
</CardGroup>

View File

@@ -0,0 +1,38 @@
---
title: التنقل
description: خصص الشريط الجانبي الأيسر ليتوافق مع طريقة عمل فريقك.
---
يعد الشريط الجانبي الأيسر طريقتك الأساسية للتنقل داخل Twenty. إنه قابل للتخصيص بالكامل — يمكنك إعادة تنظيمه ليتوافق مع سير عملك دون الحاجة إلى فتح أي صفحة إعدادات.
## إعادة ترتيب العناصر
اسحب وأفلت أي عنصر في الشريط الجانبي لتغيير موضعه. يحفظ الترتيب لكل مستخدم على حدة، لذا يمكن لكل عضو في الفريق ترتيب شريطه الجانبي الخاص.
## مجلدات
اجمع العناصر ذات الصلة في مجلدات. على سبيل المثال، يمكنك إنشاء مجلد "المبيعات" يضم طرق عرض مسار المبيعات، ومجلد "الدعم" للتذاكر، أو مجلد "العمليات" للكائنات الداخلية.
لإنشاء مجلد، انقر بزر الماوس الأيمن في الشريط الجانبي أو استخدم زر `+`.
## إخفاء الكائنات
يمكن إخفاء الكائنات التي لا تستخدمها من الشريط الجانبي. لا يتم حذفها — إنها فقط مخفية عن الأنظار. يمكنك إظهارهم مرة أخرى في أي وقت من الإعدادات → نموذج البيانات.
## المفضلات
قم بتثبيت طرق العرض أو السجلات أو عمليات البحث في قسم المفضلات أعلى الشريط الجانبي للوصول بنقرة واحدة. المفضلات شخصية — يدير كل مستخدم قائمته الخاصة.
## روابط مخصصة
أضف روابط إلى الأدوات الخارجية مباشرة في الشريط الجانبي. مفيد لربط الويكي الخاص بك ولوحات المعلومات في أدوات أخرى أو أي عنوان URL يستخدمه فريقك بانتظام.
## قائمة الأوامر
اضغط `Cmd+K` (أو `Ctrl+K`) لفتح قائمة الأوامر — شريط بحث للوصول السريع يتيح لك الانتقال إلى أي سجل أو طريقة عرض أو إجراء دون التنقل عبر الشريط الجانبي.
## تخصيص الشريط الجانبي
لتخصيص الشريط الجانبي، مرّر المؤشر فوق قسم "مساحة العمل" في الشريط الجانبي وانقر على أيقونة مفتاح الربط.
<img src="/images/user-guide/layout/navigation-edit-icon.png" alt="أيقونة تحرير التنقّل" />

View File

@@ -0,0 +1,61 @@
---
title: صفحات السجل
description: خصص تخطيط صفحات تفاصيل السجلات باستخدام علامات تبويب وأدوات.
---
## نظرة عامة
عند فتح سجل في Twenty، تتكون صفحة التفاصيل من **علامات تبويب** و**أدوات**. كلاهما قابل للتخصيص بالكامل حسب نوع الكائن.
## علامات التبويب
يمكن أن تحتوي كل صفحة سجل على عدة علامات تبويب — مشابهة لعلامات التبويب في المتصفح. استخدمها لتنظيم الجوانب المختلفة للسجل. على سبيل المثال، قد يحتوي سجل شركة على علامات تبويب مثل نظرة عامة والاتصالات والمهام والملفات.
يمكنك:
* إضافة علامات التبويب وإزالتها
* إعادة تسمية علامات التبويب
* أعد ترتيب علامات التبويب بالسحب
* حدد علامة التبويب التي تظهر افتراضيًا
## الأدوات
الأدوات هي اللبنات الأساسية داخل كل علامة تبويب. تشمل أنواع الأدوات المتاحة:
| أداة | ما الذي تعرضه |
| ----------------------- | ----------------------------------------- |
| **حقول** | حقول السجل، مجمّعة أو بشكل فردي |
| **السجلات المرتبطة** | جدول سجلات مرتبطة عبر علاقة |
| **الرسائل الإلكترونية** | سجل البريد الإلكتروني من الحسابات المتصلة |
| **التقويم** | أحداث التقويم المرتبطة بالسجل |
| **الجدول الزمني** | سجل الأنشطة والأحداث |
| **المهام** | المهام المرتبطة |
| **الملاحظات** | ملاحظات بنص منسق |
| **الملفات** | مرفقات الملفات |
| **الرسوم البيانية** | بيانات مرئية من السجلات المرتبطة |
| **iFrame** | محتوى خارجي مُضمّن |
| **نص منسق** | محتوى ثابت أو أوصاف |
## تخصيص صفحة السجل
1. افتح أي سجل
2. اضغط على `Cmd+K` وابحث عن "تحرير تخطيط صفحة السجل"
أو
1. انتقل إلى الإعدادات → نموذج البيانات → الكائن الذي تختاره → التخطيط
2. انقر على الزر "تخصيص صفحة السجل" لذلك الكائن
3. أنت الآن في وضع التخصيص:
* **أضف أدوات** من منتقي الأدوات
* **اسحب الأدوات** لإعادة وضعها على الشبكة
* **غيّر حجم الأدوات** بسحب حوافها
* **اضبط الحقول** المعروضة داخل كل أداة
* **أدِر علامات التبويب** — أضف، أزل، أعد التسمية، وأعد الترتيب
4. احفظ تغييراتك — سيتم تطبيقها على جميع السجلات لذلك النوع من الكائنات
## ظهور الحقول
ضمن أداة الحقول، يمكنك التحكّم في أي الحقول مرئية وبأي ترتيب. يتيح لك ذلك إنشاء تخطيطات مركّزة — على سبيل المثال، إظهار الحقول الأهم فقط في علامة تبويب نظرة عامة ووضع الحقول التفصيلية في علامة تبويب منفصلة.

View File

@@ -0,0 +1,45 @@
---
title: التخطيط
description: خصص كيفية التنقل، والتصفح، وعرض السجلات في Twenty.
---
تخطيط Twenty قابل للتخصيص على ثلاثة مستويات: كيفية التنقل في التطبيق، وكيفية تصفح قوائم السجلات، وما تراه عند فتح سجل فردي.
## التنقل
الشريط الجانبي الأيسر قابل للتخصيص بالكامل. يمكنك:
* **إعادة ترتيب العناصر** عن طريق السحب والإفلات
* **إنشاء مجلدات** لتجميع الكائنات وطرق العرض ذات الصلة
* **إخفاء الكائنات** التي لا تستخدمها
* **إضافة روابط مخصصة** إلى الأدوات الخارجية
* **تثبيت المفضلات** للوصول السريع إلى طرق العرض، أو السجلات، أو عمليات البحث
[مرجع التنقل →](/l/ar/user-guide/layout/capabilities/navigation)
## العروض
تتحكم طرق العرض في كيفية عرض قوائم السجلات. تدعم Twenty ثلاثة أنواع من طرق العرض:
| عرض | الأفضل لـ |
| ----------- | ------------------------------------------------------------------------- |
| **جدول** | العمل مع العديد من السجلات دفعة واحدة — صفوف وأعمدة بأسلوب جداول البيانات |
| **كانبان** | تتبّع مسار الصفقات — بطاقات قابلة للسحب والإفلات مُنظَّمة حسب المرحلة |
| **التقويم** | التخطيط القائم على الوقت — سجلات موزَّعة وفق حقل التاريخ |
يحفظ كل عرض عوامل التصفية الخاصة به، والفرز، وظهور الحقول، وإعدادات التجميع. يمكن مشاركة طرق العرض مع مساحة العمل أو إبقاؤها خاصة.
[طرق عرض الجدول →](/l/ar/user-guide/views-pipelines/capabilities/table-views) · [طرق عرض كانبان →](/l/ar/user-guide/views-pipelines/capabilities/kanban-views) · [عرض التقويم →](/l/ar/user-guide/views-pipelines/capabilities/calendar-view)
## صفحات السجل
عند فتح سجل، تتكوّن صفحة التفاصيل من علامات تبويب وعناصر واجهة قابلة للتهيئة. يمكنك:
* **إضافة علامات التبويب وإزالتها وإعادة ترتيبها** على أي نوع من السجلات
* **تكوين القطع** - الحقول، السجلات ذات الصلة، رسائل البريد الإلكتروني، الجدول الزمني، المهام، الملاحظات، الملفات، المخططات، الاطار، والمزيد
* **سحب عناصر الواجهة وتغيير حجمها** ضمن تخطيط شبكي
* **التحكم في ظهور الحقول** لكل عنصر واجهة
ادخل وضع تخصيص التخطيط من قائمة الأوامر (`Cmd+K` → "تعديل تخطيط صفحة السجل").
[مرجع صفحات السجل →](/l/ar/user-guide/layout/capabilities/record-pages)

View File

@@ -0,0 +1,125 @@
---
title: الأسئلة القانونية المتكررة
description: الأسئلة القانونية الشائعة المتكررة.
---
## إقامة البيانات والتحويلات الدولية
<AccordionGroup>
<Accordion title="في أي دولة ومنطقة سيتم تخزين بيانات مساحة العمل لدينا والمرفقات والسجلات والنسخ الاحتياطية؟">
Twenty Cloud تعمل على خوادم AWS الموجودة في فرانكفورت، ألمانيا.
</Accordion>
<Accordion title="هل يمكن تثبيت منطقة الاستضافة تعاقديًا لمساحة العمل لدينا؟">
ستكون إمكانية اختيار منطقة الاستضافة متاحة بدءًا من عام 2027، في البداية لمساحات العمل الجديدة فقط. سيتمكّن المستخدمون من طلب تغيير المنطقة لمساحة عمل قائمة في وقت لاحق. بدلًا من ذلك، يمكنك التواصل مع [شركائنا](https://twenty.com/partners/list?categories=HOSTING) لمساعدتك في إعداد المثيل الخاص بك.
</Accordion>
<Accordion title="ما الجهات المعالجة الفرعية (Sub-processors) التي يمكنها معالجة بيانات الـ CRM الخاصة بنا أو الوصول إليها، وفي أي دول تقع؟">
تتوفّر قائمة بجميع المعالِجين الفرعيين في [مركز الثقة الخاص بنا](https://trust.twenty.com/?tab=subprocessors).
</Accordion>
<Accordion title="ما الضمانات المطبَّقة على التحويلات الدولية للبيانات؟">
تنطبق بنود التعاقد القياسية للاتحاد الأوروبي، مع الملحق الخاص بالمملكة المتحدة والتعديلات السويسرية، على عمليات النقل الدولية للبيانات خارج الاتحاد الأوروبي، بما في ذلك عمليات النقل إلى جميع المعالِجين الفرعيين.
</Accordion>
</AccordionGroup>
## اتفاقية معالجة البيانات والأدوار القانونية
<AccordionGroup>
<Accordion title="أين يمكننا العثور على اتفاقية معالجة البيانات الحالية (DPA)؟">
يمكنك إنشاء نسخة موقَّعة من اتفاقية معالجة البيانات (DPA) الخاصة بك على العنوان https://{your-domain}/settings/legal/dpa (على سبيل المثال https://getting-started.twenty.com/settings/legal/dpa).
</Accordion>
<Accordion title="هل تتصرف Twenty بوصفها &#x22;معالج بيانات&#x22; لمعلومات التجار وجهات الاتصال المخزَّنة في الـ CRM، بينما تظل شركتنا &#x22;متحكِّم البيانات&#x22;؟">
وفقًا لـ [سياسة الخصوصية](https://twenty.com/privacy-policy) الخاصة بنا، تعمل Twenty بوصفها معالج البيانات لمعلومات التجار وجهات الاتصال المخزَّنة في الـ CRM، بينما تظل شركتك متحكِّم البيانات.
</Accordion>
<Accordion title="هل تُستخدم محتويات الـ CRM مطلقًا في تدريب نماذج الذكاء الاصطناعي الخاصة بـ Twenty أو النماذج التابعة لأطراف ثالثة؟">
يمكن استخدام محتوى CRM لتدريب نماذج الذكاء الاصطناعي بحسب الشروط والأحكام الخاصة بالمعالِجين الفرعيين. لا تمتلك Twenty نموذج ذكاء اصطناعي خاصًا بها — فجميع نماذج الذكاء الاصطناعي المتاحة على Twenty Cloud يوفّرها المعالِجون الفرعيون لدينا.
</Accordion>
<Accordion title="إذا وُجدت معالجة اختيارية بالذكاء الاصطناعي، فهل يمكن تعطيلها بالكامل لمساحة العمل لدينا؟">
يمكن تعطيل الذكاء الاصطناعي بالكامل من خلال إيقاف جميع نماذج الذكاء الاصطناعي في الإعدادات → AI → النماذج. بالإضافة إلى ذلك، لا تُرسَل أي بيانات إلى الذكاء الاصطناعي ما لم تتفاعل بنشاط مع دردشة الذكاء الاصطناعي أو عقدة ذكاء اصطناعي في سير عمل.
</Accordion>
</AccordionGroup>
## الأمان وضوابط الوصول
<AccordionGroup>
<Accordion title="هل يُستخدم التشفير أثناء النقل وفي حالة السكون، وما هي ممارسات إدارة المفاتيح لديكم، وكيف يتم عزل بيانات المستأجرين؟">
يتم تشفير جميع البيانات أثناء النقل وفي حالة السكون. يتم عزل بيانات المستأجرين من خلال إعداد مخطط (schema) لكل مستأجر، كما يتم تدوير مفاتيح التشفير دوريًا.
</Accordion>
<Accordion title="ما أفراد فريق Twenty أو الجهات المعالجة الفرعية الذين يمكنهم الوصول إلى مساحات عمل العملاء، ولأي أغراض، وكيف تتم الموافقة على هذا الوصول وتسجيله؟">
قد تتمكّن فرق الهندسة والدعم في Twenty من الوصول إلى مساحات عمل العملاء للتحقيق في المشكلات وحلّها. يتحكّم مالكو مساحة العمل في ذلك: يمكن تعطيل وصول الدعم في أي وقت من خلال الانتقال إلى Settings → General → Security، وسيظل معطّلًا حتى تقوم بتفعيله مرة أخرى.
</Accordion>
<Accordion title="ما هي عملية الإخطار بالحوادث والإطار الزمني المستهدف للإخطار بعد حادثة أمان مؤكدة تؤثِّر على بياناتنا؟">
في حال حدوث خرق مؤكد للبيانات الشخصية يؤثِّر على بياناتك، سنقوم بإخطارك دون تأخير غير مبرَّر وعلى أي حال خلال 48 ساعة من علمنا به. سيتضمَّن إخطارنا، بقدر ما هو معروف في ذلك الوقت: طبيعة الخرق، وفئات البيانات والأعداد التقريبية للبيانات والأفراد المتأثِّرين، والعواقب المحتملة، وإجراءات المعالجة والتخفيف المتخذة أو المخطَّط لها. سنزوِّدك بتحديثات كلما تقدَّم التحقيق.
</Accordion>
</AccordionGroup>
## الاحتفاظ بالبيانات وحذفها
<AccordionGroup>
<Accordion title="عند حذف سجل CRM فردي، متى يُزال من الأنظمة النشطة؟">
عندما يُحذَف سجلّ ما، يتم حذفه مبدئيًا حذفًا منطقيًا (soft delete) ويظل من الممكن استعادته. يُحذَف السجلّ نهائيًا ويُزال من الأنظمة النشطة بمجرد انقضاء فترة الاحتفاظ أو عندما يقوم مستخدم بحذفه يدويًا حذفًا نهائيًا.
</Accordion>
<Accordion title="ما المدة التي تُحفَظ فيها السجلات المحذوفة حذفًا منطقيًا في النظام؟">
افتراضيًا، تُحفَظ السجلات المحذوفة حذفًا منطقيًا لمدة 14 يومًا، وبعد ذلك تُزال نهائيًا من النظام. يمكن تغيير فترة الاحتفاظ بالسجلات المحذوفة حذفًا منطقيًا من الإعدادات → عام → الأمان.
</Accordion>
<Accordion title="ما المدَّة التي يمكن أن يظل فيها هذا السجل في النسخ الاحتياطية أو السجلات التقنية؟">
يبقى السجلّ الذي تمت إزالته في النسخ الاحتياطية لمدة 30 يومًا، وبعد ذلك يُحذَف نهائيًا.
</Accordion>
<Accordion title="عند إغلاق مساحة عمل أو طلب الحذف الكامل، ما الجدول الزمني الدقيق المطبَّق على بيانات الإنتاج والمرفقات والسجلات والنسخ الاحتياطية؟">
عند حذف مساحة عمل، تتم إزالة بياناتها من الأنظمة العاملة خلال نحو 90 يومًا من إنهاء الخدمة، وعادةً في وقت أقرب بكثير. ثم تُجرى الكتابة فوق النسخ الاحتياطية والأرشيفية أو تُحذف خلال 90 يومًا إضافية، وبعد ذلك تُحذف جميع البيانات نهائيًا. طوال هاتين الفترتين تكون البيانات معزولة عن أي استخدام تشغيلي. عند الطلب، يمكننا تقديم شهادة خطية عند اكتمال عملية الحذف. راجع البند 4.9 من اتفاقية معالجة البيانات الخاصة بك للاطّلاع على الشروط الكاملة.
</Accordion>
<Accordion title="خلال أي فترة احتفاظ بالنسخ الاحتياطية، هل تكون البيانات المحذوفة معزولة عن الوصول والتشغيل الفعلي؟">
نعم، خلال أي فترة احتفاظ بالنسخ الاحتياطية، تكون البيانات المحذوفة معزولة عن الاستخدام التشغيلي.
</Accordion>
<Accordion title="هل يتم الاحتفاظ بأي فئات من البيانات لفترة أطول لأغراض قانونية أو فوترة أو منع الاحتيال أو الأمان أو التدقيق؟ إذا كانت الإجابة نعم، فما هي الفئات ولأي مدة؟">
للمزيد من المعلومات حول الاحتفاظ بالبيانات، يمكنك طلب سياسة إدارة البيانات والاحتفاظ بها الخاصة بنا والمتاحة في [مركز الثقة لدينا](https://trust.twenty.com/?tab=documents).
</Accordion>
<Accordion title="هل يمكن لـ Twenty تقديم تأكيد كتابي عند اكتمال تنفيذ طلب الحذف الكامل؟">
نحن نقر بطلبات المحو ونقدِّم تأكيدًا كتابيًا بمجرد اكتمال الحذف.
</Accordion>
</AccordionGroup>
## النسخ الاحتياطية والمرونة
<AccordionGroup>
<Accordion title="ما هي وتيرة إنشاء النسخ الاحتياطية وفترة الاحتفاظ بها؟">
يتم إنشاء النسخ الاحتياطية باستمرار مع أخذ لقطات يومية، وتبلغ فترة الاحتفاظ 30 يومًا.
</Accordion>
<Accordion title="ما هدف نقطة الاستعادة (RPO) وهدف زمن الاستعادة (RTO) لـ Twenty Cloud؟">
كلٌّ من RTO وRPO هو 6 ساعات (وفقًا لاتفاقية DPA الخاصة بنا).
</Accordion>
<Accordion title="ما هي عملية طلب أو تنفيذ عملية استعادة؟">
لطلب استعادة، يُرجى التواصل مع فريقنا عبر دردشة الدعم أو عبر البريد إلى [contact@twenty.com](mailto:contact@twenty.com).
</Accordion>
<Accordion title="هل النسخ الاحتياطية مشفَّرة ومخزَّنة في نفس المنطقة التي تُخزَّن فيها بيانات مساحة العمل الأساسية؟">
جميع النسخ الاحتياطية مشفَّرة ومخزَّنة في مواقع منفصلة جغرافيًا داخل نفس الولاية القضائية (على سبيل المثال داخل الاتحاد الأوروبي بالنسبة لبيانات الاتحاد الأوروبي).
</Accordion>
</AccordionGroup>
## الامتثال
<AccordionGroup>
<Accordion title="هل Twenty ممتثلة للائحة GDPR؟">
نعم، Twenty [ممتثلة للائحة GDPR](https://trust.twenty.com/?tab=securityControls\&frameworks=gdpr_v1).
</Accordion>
<Accordion title="هل Twenty ممتثلة لمعيار SOC 2؟">
نعم، Twenty [ممتثلة لمعيار SOC 2](https://trust.twenty.com/?tab=securityControls\&frameworks=soc2_v1).
</Accordion>
<Accordion title="هل Twenty ممتثلة لمعيار HIPAA؟">
لا، Twenty في طور تحقيق الامتثال لمعيار HIPAA.
</Accordion>
</AccordionGroup>
## الترخيص
<AccordionGroup>
<Accordion title="إذا قمتُ بتعديل الكود لإضافة ميزات للاستخدام الداخلي من قِبل فريقي فقط، هل يجب عليَّ نشر هذه التغييرات؟">
لا. تشغيل نسخة معدلة لفريقك الداخلي فقط لا يُعد توزيعًا، لذلك لا ينشأ أي التزام بالنشر. تنطبق فقرة الشبكة في رخصة AGPL عندما يتفاعل أشخاص من خارج مؤسستك مع نسختك المعدلة عبر الشبكة.
</Accordion>
<Accordion title="إذا أنشأت واجهة أمامية منفصلة واستخدمت Twenty كواجهة خلفية بدون أي تعديل، فهل يجب عليَّ نشر تلك التغييرات؟">
لا. الواجهة الأمامية الخاصة بك هي عمل منفصل مملوك لك، والتواصل مع Twenty من خلال واجهاتها البرمجية (APIs) لا يغيِّر من ذلك. نظرًا لأن Twenty نفسها غير معدَّلة، فلا يوجد ما يجب نشره.
</Accordion>
<Accordion title="إذا غيَّرت الشيفرة لإضافة مزايا بهدف إعادة بيعها، فهل يجب عليَّ نشر تلك التغييرات؟">
نعم، بما أنك تعدِّل الشيفرة لتوزيعها على الآخرين، فأنت مُلزَم بنشر تلك التغييرات. إذا لم ترغب في نشر تعديلاتك، يمكنك الحصول على رخصة Organization.
</Accordion>
</AccordionGroup>
إذا كان لديك مزيد من الأسئلة، يُرجى الاطلاع على [الشروط والأحكام](https://twenty.com/terms)، و[سياسة الخصوصية](https://twenty.com/privacy-policy)، و[مركز الثقة](https://trust.twenty.com/). إذا لم تتم الإجابة عن أسئلتك بعد، فأرسِلها إلى [contact@twenty.com](mailto:contact@twenty.com) أو عبر دردشة الدعم.

View File

@@ -0,0 +1,12 @@
---
title: قانوني
description: أمور متعلقة بالشؤون القانونية
---
اطلع على [الأسئلة الشائعة](/l/ar/user-guide/legal/how-tos/legal-faq).
## روابط مفيدة
* [الشروط والأحكام](https://twenty.com/terms)
* [سياسة الخصوصية](https://twenty.com/privacy-policy)
* [مركز الثقة](https://trust.twenty.com/)

View File

@@ -0,0 +1,213 @@
---
title: الصلاحيات
description: تحكّم في الوصول إلى الكائنات والحقول والإعدادات باستخدام أذونات مستندة إلى الأدوار.
---
نظام أذونات Twenty يمكنك من التحكم في الوصول إلى ثلاثة مجالات رئيسية:
* **الكائنات والحقول**: التحكم بمن يمكنه عرض أو تعديل أو حذف السجلات والحقول الفردية
* **الإعدادات**: إدارة الوصول إلى تكوين مساحة العمل والوظائف الإدارية
* **الإجراءات**: التحكم في الإجراءات العامة لمساحة العمل مثل استيراد البيانات أو إرسال رسائل البريد الإلكتروني
## إنشاء دور
لإنشاء دور جديد:
1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. تحت **كل الأدوار**، انقر على **+ إنشاء دور**
3. أدخل اسم الدور
4. في علامة التبويب الافتراضية **الأذونات**، [كوّن الأذونات](#customize-permissions)
5. انقر على **حفظ** للإنهاء
## حذف دور
لحذف دور:
1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. انقر على الدور الذي ترغب في إزالته
3. افتح علامة التبويب **الإعدادات**، ثم انقر على **حذف الدور**
4. انقر على **تأكيد** في النافذة المنبثقة
<Note>
إذا تم حذف دور ما، فسيُعاد تعيين أي عضو في مساحة العمل مُعيَّن إلى ذلك الدور تلقائيًا إلى الدور الافتراضي. يمكن حذف جميع الأدوار باستثناء دور **المدير**. يجب دائمًا أن يكون هناك عضو واحد على الأقل معين على دور **المشرف**.
</Note>
## تخصيص الأدوار للأعضاء
### عرض التعيينات الحالية
* انتقل إلى **الإعدادات → الأعضاء → الأدوار**
* رؤية جميع الأدوار وعدد الأعضاء المعينين لكل منها
* عرض الأعضاء الذين لديهم الأدوار المختلفة
### تعيين دور لعضو
1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. انقر على الدور الذي ترغب في تعيينه
3. افتح علامة التبويب **التعيين**
4. انقر على **+ تعيين لعضو**
5. اختر عضو مساحة العمل من القائمة
6. أكد التعيين
### تعيين الدور الافتراضي
1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. في قسم **الخيارات**، اعثر على **الدور الافتراضي**
3. اختر أي دور يجب أن يحصل عليه الأعضاء الجدد تلقائيًا
4. سيتم تعيين أعضاء مساحة العمل الجدد هذا الدور عند انضمامهم
<Note>
يمكنك فقط تعيين الأدوار لأعضاء مساحة العمل الحاليين. لدعوة أعضاء جدد، استخدم [إدارة الأعضاء](/l/ar/user-guide/settings/capabilities/member-management).
</Note>
## تخصيص الأذونات
تحدد الأذونات ما يمكن لكل دور الوصول إليه أو تعديله داخل مساحة العمل الخاصة بك، بما في ذلك الأجسام والسجلات والإعدادات والإجراءات في فضاء العمل.
### أذونات الكائنات
يحدّد قسم **الكائنات** ما يمكن لهذا الدور فعله بالسجلات في مساحة عملك.
#### تعيين الأذونات الافتراضية (جميع الكائنات)
أولًا، كوّن أذونات الأساس التي تنطبق افتراضيًا على **جميع الكائنات**:
| الإذن | الوصف |
| --------------------------------- | -------------------------------------------- |
| **عرض السجلات في جميع العناصر** | عرض السجلات في القوائم وصفحات التفاصيل |
| **تحرير السجلات في جميع العناصر** | تعديل السجلات الموجودة |
| **حذف السجلات من جميع العناصر** | حذف السجلات حذفًا غير نهائي (يمكن استعادتها) |
| **إتلاف السجلات في جميع العناصر** | حذف السجلات نهائيًا |
حدّد أو أزل التحديد استنادًا إلى ما ينبغي أن يكون السلوك الافتراضي لهذا الدور.
<Note>
**مثال — دور المتدرب**: ينبغي للمتدرب أن يتمكن من رؤية جميع الكائنات ولكن دون تحريرها افتراضيًا. فعّل "عرض السجلات على جميع الكائنات" لكن اترك "تحرير السجلات على جميع الكائنات" غير محددة.
</Note>
#### إضافة استثناءات على مستوى الكائن
بعد تعيين القيم الافتراضية، استخدم القسم الفرعي **على مستوى الكائن** لإضافة قواعد تتجاوز القيم الافتراضية لكائنات محددة.
انقر على **+ إضافة قاعدة** ثم اختر كائنًا لإنشاء استثناء.
**أمثلة على قواعد لدور المتدرب:**
| قاعدة | النتيجة |
| ------------------------------- | ----------------------------------------------------------- |
| الفرص → تعطيل "عرض السجلات" | لا يمكن للمتدرب رؤية كائن الفرص إطلاقًا |
| الأشخاص → تفعيل "تحرير السجلات" | يمكن للمتدرب تحرير سجلات الأشخاص (ولكن ليس الكائنات الأخرى) |
### أذونات مستوى الصف
<Note>
أذونات مستوى الصف هي **ميزة Premium** متاحة ضمن خطة **Organization** (السحابي والمستضاف ذاتيًا).
</Note>
تتيح لك أذونات مستوى الصف تقييد السجلات الفردية التي يمكن للدور عرضها أو تعديلها، بناءً على معايير ديناميكية. على عكس أذونات الكائن (التي تنطبق على نوع الكائن بالكامل)، تقوم أذونات مستوى الصف بتقييم كل سجل بشكل مستقل.
**أمثلة لحالات الاستخدام:**
* يمكن لمندوبي المبيعات رؤية الفرص الخاصة بهم فقط
* يمكن للمديرين رؤية جميع السجلات في منطقتهم
* يمكن لوكلاء الدعم عرض التذاكر المخصصة لهم فقط
لتهيئة أذونات مستوى الصف، افتح دورًا معيّنًا، وانتقل إلى علامة تبويب **Objects**، واستخدم قسم **Row-Level** لتحديد شروط التصفية لكائن معيّن.
### أذونات الحقول
داخل كل قاعدة على مستوى الكائن، يمكنك المتابعة أبعد من ذلك وتكوين **أذونات على مستوى الحقل** للتحكم في الوصول إلى حقول محددة.
| الإذن | الوصف |
| --------------- | ------------------ |
| **عرض الحقل** | عرض قيمة الحقل |
| **تحرير الحقل** | تعديل قيمة الحقل |
| **لا وصول** | الحقل مخفي بالكامل |
**مثال — تقييد الحقول الحساسة:**
بالنسبة لدور المتدرب الذي لديه إمكانية تحرير الأشخاص، قد ترغب في تقييد حقول معينة:
* الأشخاص → البريد الإلكتروني → **عرض الحقل** فقط (لا يمكن التحرير)
* الأشخاص → العنوان → **لا وصول** (مخفي بالكامل)
يسمح هذا للمتدرب بتحرير معظم حقول الأشخاص مع حماية المعلومات الحساسة.
### كيفية عمل توريث الأذونات
تتدرج الأذونات من العام إلى المحدّد:
1. **جميع الكائنات** → يحدّد الأساس لجميع الكائنات
2. **قواعد على مستوى الكائن** → تتجاوز الأساس لكائنات محددة
3. **قواعد على مستوى الحقل** → تتجاوز إعداد الكائن لحقول محددة
الإعدادات الأكثر تحديدًا لها الأسبقية دائمًا.
### إدارة تجاوزات الأذونات
لتجاوز الأذونات الموروثة:
1. انقر على **X** لإزالة القاعدة الموروثة
2. حدّد الأذونات المحددة التي تريدها
3. انقر على أيقونة **تراجع** البرتقالية (السهم الدائري) للتراجع عن التغييرات
عند الانتهاء، انقر على **إنهاء**، ثم **حفظ** عند العودة إلى صفحة الدور.
### أذونات إعدادات مساحة العمل
تحكم في الوصول إلى إعدادات مساحة العمل بطريقتين:
* تبديل **الوصول الكامل للإعدادات** لمنح الوصول الكامل
* أو تمكين أذونات محددة (مثل توليد مفتاح API، تفضيلات مساحة العمل، تعيين الأدوار، تكوين نموذج البيانات، إعدادات الأمان، وإدارة الحركات)
<Note>
**قيد حالي**: يلزم الحصول على حق الوصول إلى إدارة سير العمل لبدء تشغيل عمليات سير العمل يدويًا. قد يتغير هذا السلوك في الإصدارات المستقبلية.
</Note>
### أذونات الإجراءات في مساحة العمل
التحكم في الوصول إلى الإجراءت العامة لمساحة العمل:
* تبديل **الوصول الكامل للتطبيق** لمنح الأذونات الكاملة
* أو تمكين الإجراءات الفردية مثل **إرسال البريد الإلكتروني**، **استيراد CSV**، و**تصدير CSV**
## تعيين أدوار لمفاتيح API ووكلاء AI
إضافةً إلى أعضاء مساحة العمل، يمكن أيضًا تعيين الأدوار إلى **مفاتيح API** و**وكلاء الذكاء الاصطناعي**. يساعد هذا بشكل خاص الفرق التي تريد التحكم بدقة في "من" يمكنه فعل ماذا في مساحة عملها—بما في ذلك العمليات المؤتمتة والتكاملات.
### لماذا نعيّن الأدوار لمفاتيح API ووكلاء الذكاء الاصطناعي؟
* **الأمان**: حدّد ما يمكن للعمليات المؤتمتة الوصول إليه أو تعديله
* **الامتثال**: تأكد من أن التكاملات لا تتعامل إلا مع البيانات التي تحتاجها
* **التحكم**: منع تغييرات البيانات العرضية الناتجة عن أتمتة مُعدّة بشكل غير صحيح
* **قابلية التدقيق**: تتبّع الإجراءات التي نفّذها كل تكامل أو وكيل
### تعيين دور لمفتاح API
1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. انقر على الدور الذي ترغب في تعيينه
3. افتح علامة التبويب **التعيين**
4. ضمن **مفاتيح API**، انقر على **+ تعيين إلى مفتاح API**
5. اختر مفتاح API من القائمة
6. أكد التعيين
سيرث مفتاح API الآن جميع الأذونات المحددة بواسطة ذلك الدور. سيتم تقييد أي استدعاءات API تُجرى بهذا المفتاح وفقًا لذلك.
<Note>
تستخدم مفاتيح API التي لم يُعيَّن لها دور الأذونات الافتراضية. لأمانٍ أشد، عيّن دائمًا دورًا محددًا لمفاتيح API في بيئة الإنتاج.
</Note>
### تعيين دور لوكيل ذكاء اصطناعي
1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. انقر على الدور الذي ترغب في تعيينه
3. افتح علامة التبويب **التعيين**
4. ضمن **وكلاء الذكاء الاصطناعي**، انقر على **+ تعيين إلى وكيل ذكاء اصطناعي**
5. اختر وكيل الذكاء الاصطناعي من القائمة
6. أكد التعيين
سيتمكن وكيل الذكاء الاصطناعي فقط من الوصول إلى البيانات وتنفيذ الإجراءات المسموح بها من قِبل دوره المعيّن.
<Note>
بالنسبة لوكلاء الذكاء الاصطناعي الذين يعملون ضمن سير العمل، يضمن ذلك أن الوكيل لا يمكنه الوصول إلى البيانات أو تعديلها خارج نطاقه المقصود—حتى إذا كان سير العمل يمتلك أذونات أوسع.
</Note>

View File

@@ -0,0 +1,125 @@
---
title: تكوين SSO
description: قم بتكوين تسجيل الدخول الأحادي لضمان مصادقة مؤسسية آمنة.
---
## نبذة عن SSO
يتيح تسجيل الدخول الأحادي (SSO) لأعضاء فريقك تسجيل الدخول إلى Twenty باستخدام موفّر الهوية الخاص بمؤسستك. يوفّر هذا ما يلي:
* **التحكم المركزي في الوصول**: إدارة الوصول من مكان واحد
* **أمان معزَّز**: الاستفادة من سياسات الأمان الحالية لديك
* **تجربة مستخدم أفضل**: مجموعة بيانات اعتماد واحدة لجميع الأدوات
## الموفّرون المدعومون
تدعم Twenty SSO مع:
* **SAML 2.0**: يعمل مع معظم موفّري الهوية للمؤسسات
* **Google Workspace**: للمؤسسات التي تستخدم Google
* **معرف Microsoft Entra ID** (سابقا Azure AD): لبيئات Microsoft
## إعداد SSO
### المتطلبات الأساسية
* خطة المؤسسة (مساحات العمل السحابية والمستضافة ذاتيًا)
* وصول المسؤول إلى موفّر الهوية لديك
* وصول المدير إلى مساحة العمل العشرين الخاصة بك
### خطوات التكوين
#### 1. الوصول إلى إعدادات SSO
1. اذهب إلى **الإعدادات → الأمان**
2. ابحث عن قسم **تكوين SSO**
3. انقر **Configure SSO**
#### 2) اختر موفّر الخدمة
حدّد موفّر الهوية من القائمة أو اختر "Custom SAML" للموفّرين الآخرين.
#### ٣. قم بتكوين موفّر الهوية الخاص بك
ستحتاج إلى تكوين موفّر الهوية لديك بما يلي:
* **Entity ID**: يوفّره Twenty
* **ACS URL**: عنوان URL لمعاودة الاتصال للمصادقة
* **Certificate**: للتواصل الآمن
#### 4. أدخل تفاصيل الموفّر في Twenty
* **SSO URL**: عنوان URL لتسجيل الدخول من موفّرك
* **Entity ID**: معرّف موفّرك
* **Certificate**: شهادة X.509 من موفّرك
#### 5. اختبر وفعّل
1. انقر **Test Configuration** للتحقق من الإعداد
2. فعّل SSO عند نجاح الاختبار
3. قم بتكوين تفضيلات تزويد المستخدمين
## تزويد المستخدمين
### التزويد الفوري (JIT)
* يتم إنشاء المستخدمين تلقائيًا عند أول تسجيل دخول
* يتم تعيين المستخدمين للدور الافتراضي تلقائياً
* لا حاجة لإنشاء المستخدمين يدويًا
### التزويد اليدوي
* ادعُ المستخدمين قبل أن يتمكنوا من تسجيل الدخول
* تعيين أدوار محددة مسبقًا
* مزيد من التحكم في من يمكنه الوصول إلى مساحة العمل
## إدارة مستخدمي SSO
### تعيين الأدوار
يمكن تعيين أدوار لمستخدمي SSO مثل المستخدمين العاديين:
1. انتقل إلى **الإعدادات → الأعضاء**
2. اعثر على المستخدم
3. غيّر دورهم حسب الحاجة
### سحب الوصول
لإزالة الوصول لمستخدمي SSO:
* أزِلهم من موفّر الهوية لديك، أو
* أزِلهم من مساحة عمل Twenty
## أفضل الممارسات
### الأمان
* **فرض استخدام SSO**: تعطيل تسجيل الدخول بكلمة المرور لمستخدمي SSO
* **عمليات تدقيق منتظمة**: مراجعة الوصول دوريًا
* **سياسات IdP قوية**: فرض المصادقة متعددة العوامل لدى موفّر الهوية
### إدارة المستخدمين
* **تسمية واضحة**: استخدم تسمية متسقة من الدليل لديك
* **مطابقة المجموعات**: طابق مجموعات IdP مع أدوار Twenty (إن وُجدت)
* **عملية إنهاء الخدمة**: ضمّن Twenty في سير عمل إلغاء التزويد
## استكشاف الأخطاء وإصلاحها
### المشكلات الشائعة
* **أخطاء الشهادة**: تأكد من عدم انتهاء صلاحية الشهادة
* **عدم تطابق الرابط**: تحقق من تطابق URL للرابطة بالضبط
* **المستخدم غير موجود**: تحقّق من إعدادات التزويد الفوري (JIT)
### الحصول على المساعدة
إذا واجهت مشكلات، تواصل مع الدعم وقدّم ما يلي:
* رسائل الخطأ المستلمة
* موفّر الهوية المستخدم
* تفاصيل التكوين (من دون بيانات حساسة)
<Tip>
هل تحتاج إلى إعداد SSO لمؤسستك؟ [اعثر على شريك Twenty معتمد](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-sso) متخصص في إعداد SSO والهوية. *(تفضّل إشراك Twenty مباشرةً؟ [contact@twenty.com](mailto:contact@twenty.com))*
</Tip>

View File

@@ -0,0 +1,120 @@
---
title: الأسئلة الشائعة حول الصلاحيات
description: الأسئلة الشائعة حول الأدوار والصلاحيات.
---
## الأدوار
<AccordionGroup>
<Accordion title="ما الأدوار التي تأتي مع Twenty افتراضيًا؟">
20 تأتي مع **المشرف** و **الأعضاء** بشكل افتراضي. يمكنك إنشاء أدوار مخصصة إضافية بناءً على احتياجات فريقك (مثل: مندوب مبيعات، مدير، مستخدم للقراءة فقط).
</Accordion>
<Accordion title="هل يمكنني حذف دور المشرف؟">
لا، لا يمكن حذف دور المشرف. يجب دائمًا أن يكون هناك عضو واحد على الأقل معيّنًا إلى دور المشرف.
</Accordion>
<Accordion title="ماذا يحدث عند حذف دور؟">
سيُعاد تعيين أي عضو في مساحة العمل مُعيَّن إلى ذلك الدور تلقائيًا إلى الدور الافتراضي.
</Accordion>
<Accordion title="كيف أعيّن دورًا افتراضيًا للأعضاء الجدد؟">
انتقل إلى **الإعدادات → الأعضاء → الأدوار**، وابحث عن خيار **Default Role**، ثم اختر الدور الذي يجب أن يحصل عليه الأعضاء الجدد تلقائيًا عند انضمامهم.
</Accordion>
<Accordion title="هل يمكنني تعيين عدة أدوار لمستخدم واحد؟">
لا، يمكن لكل مستخدم امتلاك دور واحد فقط في كل مرة. أنشئ دورًا مخصصًا إذا كنت تحتاج إلى مجموعة من الصلاحيات.
</Accordion>
</AccordionGroup>
## الصلاحيات
<AccordionGroup>
<Accordion title="ما الفرق بين صلاحيات الكائن وصلاحيات الحقل؟">
* **صلاحيات الكائن**: تتحكم في الوصول إلى السجلات بالكامل (مثلاً: يمكن رؤية/تعديل/حذف سجلات الأشخاص)
* **صلاحيات الحقل**: تتحكم في الوصول إلى حقول محددة داخل الكائن (مثلاً: يمكن رؤية حقل الراتب لكن لا يمكن تعديله)
تتيح صلاحيات الحقول تحكّمًا أكثر تفصيلاً بالبيانات الحساسة.
</Accordion>
<Accordion title="كيف تعمل تجاوزات الصلاحيات؟">
تتدرج الأذونات من العام إلى المحدّد:
1. **All Objects** يحدّد الأساس لجميع الكائنات
2. **Object-Level Permissions** يمكنها تجاوز الإعداد العام لكائنات محددة
3. **Field-Level Permissions** يمكنها تجاوز إعداد الكائن لحقول محددة
الإعدادات الأكثر تحديدًا لها الأسبقية دائمًا.
</Accordion>
<Accordion title="ماذا تعني مستويات الصلاحيات المختلفة؟">
بالنسبة إلى الكائنات:
* **See Records**: عرض السجلات في القوائم وصفحات التفاصيل
* **Edit Records**: تعديل السجلات الحالية
* **Delete Records**: حذف السجلات حذفًا غير نهائي (يمكن استعادتها)
* **Destroy Records**: حذف السجلات نهائيًا
بالنسبة إلى الحقول:
* **See Field**: عرض قيمة الحقل
* **Edit Field**: تعديل قيمة الحقل
* **No Access**: الحقل مخفي بالكامل
</Accordion>
<Accordion title="هل يمكنني تقييد الوصول إلى سجلات محددة (صلاحيات على مستوى الصف)؟">
تتوفر الصلاحيات على مستوى الصف ضمن خطة **Organization**. يتيح لك ذلك تقييد الوصول إلى سجلات محددة بناءً على معايير معينة (مثل: رؤية فرصك الخاصة فقط).
</Accordion>
<Accordion title="كيف أجعل حقلًا للقراءة فقط لمستخدمين معيّنين؟">
1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. اختر الدور
3. انتقل إلى الكائن الذي يحتوي على الحقل
4. عيّن صلاحية الحقل إلى **See Field** (من دون Edit Field)
</Accordion>
</AccordionGroup>
## الإعدادات والإجراءات
<AccordionGroup>
<Accordion title="ما صلاحيات الإعدادات المتاحة؟">
يمكنك التحكّم في الوصول إلى:
* إنشاء مفتاح API
* تفضيلات مساحة العمل
* تعيين الأدوار
* تكوين نموذج البيانات
* إعدادات الأمان
* إدارة سير العمل
استخدم **Settings All Access** لمنح وصول كامل، أو فعّل صلاحيات محددة.
</Accordion>
<Accordion title="ما صلاحيات الإجراءات المتاحة؟">
يمكنك التحكّم في:
* **Send Email**: إمكانية إرسال رسائل بريد إلكتروني من Twenty
* **Import CSV**: إمكانية استيراد البيانات عبر CSV
* **Export CSV**: إمكانية تصدير البيانات إلى CSV
استخدم **Application All Access** لمنح جميع الإجراءات، أو فعّل إجراءات محددة.
</Accordion>
</AccordionGroup>
## التسجيل الموحد
<AccordionGroup>
<Accordion title="هل ميزة SSO متاحة في جميع الخطط؟">
لا، SSO ميزة Premium متاحة ضمن خطة **Organization** فقط.
</Accordion>
<Accordion title="ما موفّرو الهوية المدعومون؟">
تدعم Twenty:
* **SAML 2.0** (يعمل مع معظم موفّري الهوية للمؤسسات)
* **Google Workspace**
* **Microsoft Entra ID** (سابقًا Azure AD)
</Accordion>
<Accordion title="ما هو التزويد Just-in-Time ‏(JIT)؟">
مع التزويد JIT، يتم إنشاء حسابات المستخدمين تلقائيًا في Twenty عند تسجيل الدخول عبر SSO للمرة الأولى. ويُعيَّن لهم الدور الافتراضي تلقائيًا.
</Accordion>
<Accordion title="هل يمكنني فرض SSO على جميع المستخدمين؟">
نعم، بمجرد تكوين SSO يمكنك تعطيل تسجيل الدخول بكلمة المرور لمستخدمي SSO لفرض المصادقة عبر موفّر الهوية لديك.
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,34 @@
---
title: الأذونات والوصول
description: إدارة الأدوار والأذونات والتحكم في الوصول ضمن مساحة العمل.
---
يتيح لك نظام الأذونات في Twenty التحكم بمن يمكنه الوصول إلى البيانات وتعديلها في مساحة العمل لديك. أنشئ أدوارًا، وامنح أذونات، وقم بتكوين تسجيل الدخول الأحادي (SSO) للوصول الآمن.
## ما الذي يتضمنه هذا القسم
<CardGroup cols={2}>
<Card title="الصلاحيات" icon="lock" href="/l/ar/user-guide/permissions-access/capabilities/permissions">
أنشئ أدوارًا وكوّن أذونات الكائنات والحقول والإعدادات.
</Card>
<Card title="تكوين تسجيل الدخول الأحادي (SSO)" icon="key" href="/l/ar/user-guide/permissions-access/capabilities/sso-configuration">
إعداد تسجيل الدخول الأحادي مع موفّر الهوية لديك.
</Card>
<Card title="الأسئلة الشائعة" icon="circle-question" href="/l/ar/user-guide/permissions-access/how-tos/permissions-faq">
أسئلة شائعة حول الأدوار والأذونات وتسجيل الدخول الأحادي (SSO).
</Card>
</CardGroup>
## الميزات الرئيسية
* **الوصول القائم على الأدوار**: أنشئ أدوارًا مخصّصة بأذونات محددة
* **أذونات الكائنات**: التحكم بمن يمكنه عرض أو تعديل أو حذف السجلات
* **أذونات الحقول**: تقييد الوصول إلى الحقول الحساسة
* **أذونات الإعدادات**: التحكم بالوصول إلى تكوين مساحة العمل
* **تكامل SSO**: قم بتكوين تسجيل الدخول الأحادي لأمان المؤسسات (خطة المؤسسة)
## روابط سريعة
* [إنشاء دور](/l/ar/user-guide/permissions-access/capabilities/permissions#create-a-role)
* [تكوين SSO](/l/ar/user-guide/permissions-access/capabilities/sso-configuration)
* [إدارة أعضاء الفريق](/l/ar/user-guide/settings/capabilities/member-management)

View File

@@ -0,0 +1,36 @@
---
title: إعدادات المجتمع
description: فعِّل ميزات الوصول المبكر في Twenty.
---
## حول إعدادات المجتمع
يتيح لك قسم المجتمع تمكين ميزات الوصول المبكر قبل أن تصبح متاحة للجميع، وكذلك البحث عن شركاء Twenty.
## ميزات الوصول المبكر
ميزات الوصول المبكر هي إمكانات لا تزال قيد الاختبار قبل الإتاحة العامة.
**حاليًا في الوصول المبكر:**
* **علاقات الوصل** — علاقات متعددة إلى متعددة
### كيفية تمكين ميزات الوصول المبكر
1. اذهب إلى **الإعدادات → المجتمع**
2. انتقل إلى قسم **الميزات**
3. ابحث عن الميزة التي تريد تمكينها
4. قم بتفعيلها
5. ستصبح الميزة متاحة على الفور
<Note>
قد تتغير ميزات الوصول المبكر بناءً على ملاحظات المستخدمين. تساعد ملاحظاتك على تحسين Twenty!
</Note>
## ملاحظات حول الميزات
تساعد ملاحظاتك على تحسين Twenty:
* أبلغ عن المشكلات المتعلقة بميزات الوصول المبكر
* شارك كيفية استخدامك للميزات الجديدة
* اقترح تحسينات عبر [خادم المجتمع على Discord](https://discord.gg/cx5n4Jzs57)

View File

@@ -0,0 +1,52 @@
---
title: إعدادات النطاق
description: قم بتكوين نطاق مساحة العمل، ونطاقات الوصول المعتمدة، ونطاقات التطبيقات المخصصة.
---
إعدادات النطاق موجودة في ثلاثة أماكن، حسب ما تريد تكوينه.
## نطاق مساحة العمل
تكوين تحت **الإعدادات → العام**.
قم بتعديل اسم النطاق الفرعي الخاص بك أو عيّن نطاقًا مخصصًا لمساحة العمل.
### تخصيص النطاق
1. انقر فوق **المجال الفرعي** لتحرير المجال الفرعي الخاص بك (على سبيل المثال `yourcompany.twenty.com`)
2. أو انقر فوق **نطاق مخصص** لإعداد نطاق مخصص (على سبيل المثال `crm.yourcompany.com`)
بالنسبة للنطاقات المخصصة، ستحتاج إلى تكوين إعدادات DNS مع مزود النطاق الخاص بك.
## النطاقات المعتمدة
قم بالتكوين ضمن **الإعدادات → الأعضاء → دعوة**.
أضف نطاق شركتك للسماح لأعضاء الفريق بالتسجيل في فضاء العمل هذا تلقائياً.
### إضافة نطاق وصول معتمد
1. انقر **إضافة نطاق وصول معتمد**
2. أدخل نطاق شركتك (مثل: `yourcompany.com`)
3. حفظ
بعد الإعداد، يمكن لأي شخص لديه عنوان بريد إلكتروني ضمن ذلك النطاق الانضمام إلى مساحة العمل الخاصة بك دون الحاجة إلى دعوة مباشرة.
<Note>
هذا مفيد للسماح لفريقك بالكامل بالتسجيل الذاتي مع إبقاء مساحة العمل مقصورة على مؤسستك.
</Note>
## نطاقات التطبيقات المخصصة
قم بالتكوين ضمن **الإعدادات → التطبيقات → تطبيقك → الإعدادات → عنوان URL للتطبيق**.
يتم تقديم التطبيقات التي تعرض المسارات على الويب من عنوان URL مخصص، كما هو موضح في قسم **عنوان URL للتطبيق**. يمكنك بدلاً من ذلك إتاحة التطبيق عبر نطاق تملكه.
### إضافة نطاق مخصص
1. انقر فوق **نطاق مخصص**
2. أدخل النطاق الذي تريد استخدامه (مثل: `app.yourcompany.com`)
3. قم بتكوين إعدادات DNS وفق التعليمات
4. تحقق من النطاق
يتم الوصول إلى مسارات ذلك التطبيق فقط على هذا النطاق. يتم توفير شهادات SSL تلقائيًا.

View File

@@ -0,0 +1,38 @@
---
title: إعدادات التجربة
description: تخصيص السمة الخاصة بواجهتك والتفضيلات الإقليمية.
---
خصّص تجربة Twenty ضمن **الإعدادات → التجربة**.
## المظهر
اختر السمة المرئية:
* **فاتح**: واجهة نظيفة ومشرقة
* **داكن**: مريح للعينين في ظروف الإضاءة المنخفضة
* **إعدادات النظام**: تتطابق تلقائياً مع سمة جهازك
## اللغة
اختر اللغة المفضلة لواجهة Twenty من القائمة المنسدلة.
## تنسيقات
إعداد التاريخ والوقت والرقم والمنطقة الزمنية ويوم بدء التقويم.
| الإعداد | الوصف |
| ------------------- | ---------------------------------------------------- |
| **المنطقة الزمنية** | منطقتك الزمنية المحلية لدقة الطوابع الزمنية والجدولة |
| **تنسيق التاريخ** | كيفية ظهور التواريخ (مثال: 12 ديسمبر 2025) |
| **تنسيق الوقت** | صيغة 12 ساعة (7:22 م) أو 24 ساعة |
| **تنسيق الأرقام** | فواصل الأعداد العشرية وآلافها (مثال: 1,234.56) |
| **يوم بدء التقويم** | اليوم الأول من الأسبوع (الأحد أو الاثنين) |
يمكن تعيين كل إعداد إلى **إعدادات النظام** ليتطابق تلقائياً مع تفضيلات جهازك، أو يمكنك اختيار تنسيق محدد.
## كيفية التحديث
1. انتقل إلى **الإعدادات → التجربة**
2. اضبط تفضيلاتك في كل قسم
3. يتم حفظ التغييرات تلقائياً

View File

@@ -0,0 +1,86 @@
---
title: إدارة الأعضاء
description: دعوة أعضاء الفريق وإدارة الوصول إلى مساحة العمل.
---
إدارة من لديهم حق الوصول إلى مساحة العمل الخاصة بك ضمن **الإعدادات → الأعضاء**.
## دعوة أعضاء جدد
### استخدام الدعوة عبر البريد الإلكتروني
1. انتقل إلى **الإعدادات → الأعضاء → دعوة**
2. انقر **+ دعوة**
3. أدخل عنوان البريد الإلكتروني للشخص
4. حدد دورًا للعضو الجديد
5. انقر **إرسال دعوة**
سيتلقى الشخص المدعو رسالة بريد إلكتروني تحتوي على رابط للانضمام إلى مساحة العمل الخاصة بك.
### استخدام رابط الدعوة
1. انتقل إلى **الإعدادات → الأعضاء → دعوة**
2. انسخ رابط دعوة مساحة العمل
3. شارك الرابط مع أعضاء الفريق الجدد
4. سيحصلون على الوصول بمجرد التسجيل
## عرض الأعضاء وإدارتهم
### عرض جميع الأعضاء
انتقل إلى **الإعدادات → الاعضاء → فريق** لمشاهدة جميع الاعضاء النشطين
انتقل إلى **الإعدادات → الأعضاء → دعوة** لرؤية الدعوات المعلقة
### تحرير ملف تعريف عضو
انقر على عضو لفتح صفحة ملف التعريف الخاصة به. بصفتك مسؤولًا، يمكنك:
* تحرير **الاسم**
* تحديث **صورة ملف التعريف**
* **انتحال شخصية** حسابهم (مفيد لاستكشاف الأخطاء وإصلاحها)
* **حذف** حسابهم
### تغيير دور أحد الأعضاء
في صفحة ملف تعريف العضو:
1. افتح علامة تبويب **الأذونات**
2. عرض الدور المعين حاليًا
3. حدد دورًا مختلفًا من القائمة المنسدلة
4. يسري التغيير فورًا
→ [تعرّف على المزيد حول الأدوار والأذونات](/l/ar/user-guide/permissions-access/capabilities/permissions)
### إزالة عضو
1. انقر على العضو لفتح ملف التعريف الخاص به
2. انقر فوق **حذف الحساب** لإزالتها من مساحة العمل
<Warning>
يفقد الأعضاء الذين تمت إزالتهم حق الوصول فورًا. تبقى بياناتهم (السجلات، الملاحظات، المهام) في مساحة العمل.
</Warning>
<Note>
يتم أرشيف رسائل البريد الإلكتروني وأحداث التقويم للعضو المحذوف وتكون متاحة للأعضاء الآخرين.
</Note>
## الدعوات المعلقة
إدارة الدعوات التي لم تُقبل:
* **إعادة الإرسال**: إرسال رسالة الدعوة عبر البريد الإلكتروني مرة أخرى
* **إلغاء**: سحب الدعوة قبل قبولها
## نطاقات الوصول المعتمدة
السماح لأعضاء الفريق بالانضمام تلقائيًا بناءً على نطاق بريدهم الإلكتروني:
1. انتقل إلى **الإعدادات → الأعضاء → دعوة**
2. أضف نطاق شركتك (مثل: `yourcompany.com`)
3. يمكن لأي شخص ينتمي بريده الإلكتروني إلى ذلك النطاق الانضمام من دون دعوة
## ذات صلة
* [الأذونات](/l/ar/user-guide/permissions-access/capabilities/permissions) — تحديد ما يمكن لكل دور القيام به
* [إعدادات النطاق](/l/ar/user-guide/settings/capabilities/domains-settings) - تكوين النطاقات المعتمدة

View File

@@ -0,0 +1,43 @@
---
title: إعدادات الملف الشخصي
description: إدارة ملفك الشخصي وإعدادات الأمان الشخصية.
---
## المعلومات الشخصية
### الاسم والبريد الإلكتروني
* **اسم العرض**: قم بتحديث كيفية ظهور اسمك لأعضاء مساحة العمل الآخرين
* **عنوان البريد الإلكتروني**: قم بتغيير بريد تسجيل الدخول الخاص بك (يتطلب التحقق)
* **صورة الملف الشخصي**: قم بتحميل صورة رمزية مخصصة أو استخدم الأحرف الأولى من اسمك
## إعدادات الأمان
### المصادقة الثنائية (2FA)
فعّل المصادقة الثنائية لإضافة طبقة أمان إضافية إلى حسابك:
1. اذهب إلى **الإعدادات → الملف الشخصي**
2. انقر فوق **تطبيق المصادقة**
3. قم بمسح رمز الاستجابة السريعة باستخدام تطبيق المصادقة الخاص بك
4. أدخل رمز التحقق للتأكيد
### إدارة كلمات المرور
* **تغيير كلمة المرور**: قم بتحديث كلمة المرور الحالية الخاصة بك
* **شروط كلمة المرور**: يجب ألا تقل عن 8 أحرف
## إدارة الملف الشخصي
### حذف الحساب
<Warning>
سيؤدي حذف حسابك إلى إزالة وصولك إلى جميع مساحات العمل بشكلٍ دائم. لا يمكن التراجع عن هذا الإجراء. ستفقد إمكانية الوصول إلى جميع مساحات العمل التي أنت عضو فيها. إذا كنت تريد فقط مغادرة فرق معينة، ففكر في مغادرة مساحات العمل الفردية بدلاً من ذلك.
</Warning>
لحذف حسابك:
1. اذهب إلى **الإعدادات → الملف الشخصي**
2. قم بالتمرير إلى **منطقة الخطر**
3. انقر على **حذف الحساب**
4. أكد عن طريق كتابة عنوان بريدك الإلكتروني

View File

@@ -0,0 +1,30 @@
---
title: إعدادات مساحة العمل
description: خصص اسم مساحة العمل وعلامتها التجارية.
---
صورة مساحة العمل الخاصة بك واسمك وخيارات الحذف كلها متاحة تحت **إعدادات → عام**.
## صورة مساحة العمل
* **تحميل الشعار**: إضافة شعار مخصص لمساحة العمل
* **التنسيقات المدعومة**: ملفات PNG و JPEG و GIF تحت حجم 10MB
* **إزالة**: حذف شعار مساحة العمل الحالي
## اسم مساحة العمل
* **الاسم**: تغيير اسم العرض لمساحة العمل
* يظهر هذا الاسم لجميع أعضاء مساحة العمل
## المنطقة الخطرة
<Warning>
حذف مساحة العمل الخاصة بك يزيل جميع البيانات ويلغي الوصول لجميع الأعضاء على الفور - لا يمكن التراجع عن هذا الإجراء.
</Warning>
لحذف مساحة العمل الخاصة بك:
1. انقر فوق زر **حذف مساحة العمل**
2. أكد الحذف عند الطلب
**ملاحظة**: يستطيع فقط مدراء مساحة العمل حذف المساحات.

View File

@@ -0,0 +1,171 @@
---
title: أسئلة شائعة حول الإعدادات
description: الأسئلة الشائعة حول إعدادات Twenty.
---
## إعدادات مساحة العمل
<AccordionGroup>
<Accordion title="كيف أغيّر اسم مساحة العمل الخاصة بي؟">
1. اذهب إلى **الإعدادات → عام**
2. ابحث عن حقل اسم مساحة العمل
3. أدخل الاسم الجديد
4. يتم حفظ التغييرات تلقائيًا
</Accordion>
<Accordion title="كيف أحدّث شعار مساحة العمل الخاصة بي؟">
1. اذهب إلى **الإعدادات → عام**
2. انقر على الشعار الحالي أو منطقة التحميل
3. اختر ملف صورة (PNG أو JPEG أو GIF أصغر من 10MB)
4. يتم تحديث الشعار فورًا
</Accordion>
<Accordion title="هل يمكنني امتلاك عدة مساحات عمل؟">
نعم، يمكنك إنشاء عدة مساحات عمل وأن تكون عضوًا فيها. لكل مساحة عمل بياناتها وإعداداتها واشتراكها الخاص.
</Accordion>
<Accordion title="كيف أحذف مساحة العمل الخاصة بي؟">
1. اذهب إلى **الإعدادات → عام**
2. قم بالتمرير إلى منطقة الخطر
3. انقر **حذف مساحة العمل**
4. أكد الحذف
ملاحظة: يؤدي هذا إلى حذف جميع البيانات بشكل دائم ولا يمكن التراجع عنه.
</Accordion>
<Accordion title="لقد أنشأت مساحات عمل متعددة عن طريق الخطأ. ماذا يجب أن أفعل؟">
احذف مساحات العمل التي لم تعد تحتاجها ضمن **الإعدادات → عام → حذف مساحة العمل**.
<Warning>
لا تحذف **حسابك** (يمكن الوصول إليه ضمن الإعدادات → الملف الشخصي): حسابك مشترك بين جميع مساحات العمل لديك. حذف حسابك يزيل الوصول إلى جميع مساحات العمل.
</Warning>
</Accordion>
<Accordion title="كيف أعطّل مساحة العمل الخاصة بي دون حذفها؟">
إذا كنت تريد تعطيل مساحة العمل مؤقتًا (وليس حذفها نهائيًا)، فاذهب إلى **الإعدادات → الفوترة** وانقر **إلغاء الخطة**. سيتم الاحتفاظ ببياناتك لفترة سماح.
</Accordion>
</AccordionGroup>
## إعدادات الملف الشخصي
<AccordionGroup>
<Accordion title="كيف أغيّر كلمة المرور الخاصة بي؟">
1. اذهب إلى **الإعدادات → الملف الشخصي**
2. ابحث عن قسم كلمة المرور
3. أدخل كلمة المرور الحالية
4. أدخل كلمة المرور الجديدة
5. احفظ التغييرات
</Accordion>
<Accordion title="كيف أفعّل المصادقة الثنائية؟">
1. اذهب إلى **الإعدادات → الملف الشخصي**
2. ابحث عن قسم المصادقة الثنائية (2FA)
3. انقر على **تمكين المصادقة الثنائية**
4. قم بمسح رمز الاستجابة السريعة باستخدام تطبيق المصادقة الخاص بك
5. أدخل رمز التحقق
</Accordion>
<Accordion title="هل يمكنني تغيير عنوان بريدي الإلكتروني؟">
لتغيير عنوان بريدك الإلكتروني، يُرجى التواصل عبر [contact@twenty.com](mailto:contact@twenty.com).
</Accordion>
<Accordion title="كيف أحذف حسابي؟">
1. اذهب إلى **الإعدادات → الملف الشخصي**
2. قم بالتمرير إلى منطقة الخطر
3. انقر **حذف الحساب**
4. أكد بكتابة بريدك الإلكتروني
ملاحظة: يؤدي هذا إلى إزالة وصولك إلى جميع مساحات العمل وحذف جميع الرسائل الإلكترونية المتزامنة من حساباتك المتصلة.
</Accordion>
</AccordionGroup>
## إعدادات التجربة
<AccordionGroup>
<Accordion title="كيف أبدّل بين الوضع الفاتح والوضع الداكن؟">
1. اذهب إلى **الإعدادات → التجربة**
2. ابحث عن قسم السمة
3. اختر الفاتح، الداكن، أو النظام
</Accordion>
<Accordion title="كيف أغيّر تنسيق التاريخ؟">
1. اذهب إلى **الإعدادات → التجربة**
2. ابحث عن تنسيق التاريخ
3. اختر التنسيق المفضّل لديك
4. تُطبَّق التغييرات فورًا
</Accordion>
<Accordion title="كيف أغيّر المنطقة الزمنية الخاصة بي؟">
1. اذهب إلى **الإعدادات → التجربة**
2. ابحث عن المنطقة الزمنية
3. اختر منطقتك الزمنية المحلية
4. سيتم ضبط جميع الطوابع الزمنية
</Accordion>
<Accordion title="هل يمكنني تغيير اللغة؟">
1. اذهب إلى **الإعدادات → التجربة**
2. ابحث عن اللغة
3. اختر من اللغات المتاحة
4. سيتم تحديث الواجهة وفق اختيارك.
</Accordion>
</AccordionGroup>
## إعدادات الحساب
<AccordionGroup>
<Accordion title="كيف أربط حساب البريد الإلكتروني الخاص بي؟">
1. اذهب إلى **الإعدادات → الحسابات**
2. انقر على **إضافة حساب**
3. اختر Google أو Microsoft
4. اسمح بالوصول
5. اضبط إعدادات المزامنة
</Accordion>
<Accordion title="هل يمكنني ربط عدة حسابات بريد إلكتروني؟">
نعم، يمكنك ربط عدة حسابات بريد إلكتروني. اذهب إلى **الإعدادات → الحسابات** وأضف حسابات إضافية حسب الحاجة.
</Accordion>
<Accordion title="كيف أفصل حساب بريد إلكتروني؟">
1. اذهب إلى **الإعدادات → الحسابات**
2. ابحث عن الحساب المراد إزالته
3. انقر **قطع الاتصال**
4. أكد الإجراء
</Accordion>
</AccordionGroup>
## النطاقات
<AccordionGroup>
<Accordion title="هل يمكنني تخصيص دومين مساحة العمل الخاصة بي؟">
نعم! اذهب إلى **الإعدادات → عام → نطاق مساحة العمل** ثم انقر **تخصيص النطاق**. لديك خياران:
* **النطاق الفرعي**: استخدم نطاقًا فرعيًا من Twenty مثل `yourcompany.twenty.com`
* **نطاق مخصص**: استخدم نطاقك الخاص مثل `crm.yourcompany.com` (يتطلب تهيئة DNS)
إعداد النطاق الفرعي سريع، بينما يوفّر النطاق المخصص تجربة بعلامتك التجارية بالكامل لفريقك.
</Accordion>
<Accordion title="كيف تعمل نطاقات الوصول المعتمدة؟">
يمكنك تكوين نطاقات الوصول المعتمدة بحيث يتمكن أعضاء الفريق ذوو عناوين البريد الإلكتروني الخاصة بالشركة من الانضمام تلقائيًا إلى مساحة العمل الخاصة بك. اذهب إلى **الإعدادات → الأعضاء → دعوة** وأضف نطاق شركتك (مثلًا، `yourcompany.com`).
</Accordion>
</AccordionGroup>
## ميزات الوصول المبكر
<AccordionGroup>
<Accordion title="ما هي ميزات الوصول المبكر؟">
ميزات الوصول المبكر هي إمكانات يُجرى اختبارها قبل الإصدار العام.
</Accordion>
<Accordion title="هل ميزات الوصول المبكر آمنة للاستخدام؟">
ومميزات الوصول المبكر وظيفية وآمنة للاستخدام، ولكنها قد تتغير بناء على تعليقات المستعملين قبل توافرها العام.
</Accordion>
<Accordion title="كيف أمكّن ميزات الوصول المبكر؟">
1. انتقل إلى **الإعدادات → المجتمع**
2. مرر لأسفل إلى قسم **الميزات**
3. ابحث عن الميزة التي تريدها
4. قم بتفعيلها
5. تصبح الميزة متاحة على الفور
</Accordion>
</AccordionGroup>

View File

@@ -0,0 +1,62 @@
---
title: \ا\ل\إ\ع\د\ا\د\ا\ت
description: قم بإعداد مساحة عملك في Twenty باستخدام التكوينات الأساسية.
---
## الإعداد الأولي
عند إنشاء مساحة العمل لأول مرة، توجد عدة إعدادات أساسية لتكوينها.
### اسم مساحة العمل والشعار
1. اذهب إلى **الإعدادات → عام**
2. حدّث اسم مساحة العمل
3. حمّل شعار شركتك
4. احفظ التغييرات
### المنطقة الزمنية وتنسيق التاريخ
1. اذهب إلى **الإعدادات → التجربة**
2. اختر منطقتك الزمنية
3. اختر تنسيق التاريخ المفضّل لديك
4. احفظ التغييرات
## التكوينات الأساسية
### اربط البريد الإلكتروني والتقويم
إعداد مزامنة البريد الإلكتروني والتقويم:
1. اذهب إلى **الإعدادات → الحسابات**
2. انقر على **إضافة حساب**
3. اربط حساب Google أو Microsoft الخاص بك
4. اضبط إعدادات المزامنة
→ [دليل شامل لإعداد البريد الإلكتروني والتقويم](/l/ar/user-guide/calendar-emails/overview)
### ادعُ فريقك
أضف أعضاء الفريق إلى مساحة العمل:
1. انتقل إلى **الإعدادات → الأعضاء**
2. انقر **+ دعوة**
3. أدخل عناوين البريد الإلكتروني
4. عيّن الأدوار المناسبة
<Note>
قبل دعوة فريقك، تحقّق من الدور الافتراضي ضمن **الإعدادات → الأعضاء → الأدوار**. يتم تعيين هذا الدور تلقائيًا للأعضاء الجدد عند انضمامهم.
</Note>
## قائمة التحقق لإعدادات مساحة العمل
* تم تكوين اسم مساحة العمل والشعار
* تم ضبط المنطقة الزمنية وتنسيق التاريخ
* تم ربط البريد الإلكتروني والتقويم
* تمت دعوة أعضاء الفريق
* تم إعداد الأدوار والأذونات
## الخطوات التالية
* [إعدادات مساحة العمل](/l/ar/user-guide/settings/capabilities/workspace-settings)
* [إعدادات الملف الشخصي](/l/ar/user-guide/settings/capabilities/profile-settings)
* [إعدادات التجربة](/l/ar/user-guide/settings/capabilities/experience-settings)

View File

@@ -0,0 +1,46 @@
---
title: عرض التقويم
description: اعرض السجلات التي تحتوي على حقول تاريخ على تقويم.
---
## حول عرض التقويم
يعرض عرض التقويم سجلاتك على تقويم استنادًا إلى حقل تاريخ. يظهر كل سجل كحدث في التاريخ المقابل.
<img src="/images/user-guide/views/calendar-view-zoom.png" style={{width:'100%'}} />
## إنشاء طريقة عرض التقويم
1. انتقل إلى كائن يحتوي على حقول تاريخ
2. انقر على القائمة المنسدلة لطريقة العرض → **+ إضافة طريقة عرض**
3. اسم العرض الخاص بك وانقر فوق **إنشاء**
4. افتح **الخيارات** على اليمين
5. حدد **التقويم** كتخطيط
6. اختر **حقل التاريخ** لاستخدامه في تحديد موضع السجلات
7. انقر على **تحديث طريقة العرض**
## تهيئة التقويم
### اختر حقل التاريخ
ضمن **الخيارات**، حدد أي حقل تاريخ يحدد مكان ظهور السجلات على التقويم.
### حقول العرض
قم بتهيئة الحقول التي تظهر في كل حدث في التقويم:
1. انقر على **الخيارات → الحقول**
2. بدل حالة الحقول تشغيل/إيقاف
3. اسحب لإعادة الترتيب
## حالات الاستخدام
* **الاجتماعات والمكالمات**: اعرض المواعيد القادمة
* **المواعيد النهائية**: تتبع تواريخ الاستحقاق وتواريخ الإغلاق
* **الفعاليات**: خطط وتصور الأنشطة المجدولة
* **المتابعات**: اطلع على مواعيد استحقاق المهام
## ذات صلة
* [نظرة عامة على طرق العرض](/l/ar/user-guide/views-pipelines/overview) — إنشاء طرق العرض وإدارتها
* [عوامل التصفية والفرز](/l/ar/user-guide/views-pipelines/capabilities/filters-and-sorting) — تصفية بيانات التقويم

View File

@@ -0,0 +1,52 @@
---
title: الحقول والأعمدة
description: اختر الحقول التي تريد عرضها وكيفية تنظيمها.
---
## تحديد الحقول لعرضها
يمكن لكل عرض أن يعرض مجموعة مختلفة من الحقول. خصّص ما هو مرئي للتركيز على المعلومات المهمة.
### إظهار الحقول أو إخفاؤها
1. انقر على **الخيارات** في أعلى اليمين
2. انقر على **الحقول**
3. انقر على **أيقونة العين** بجانب كل حقل لإظهاره/إخفائه
### إعادة ترتيب الحقول
غيّر ترتيب ظهور الحقول في عرضك:
1. انقر على **الخيارات → الحقول**
2. اسحب الحقول لأعلى أو لأسفل
3. يتم حفظ التغييرات تلقائيًا
## عرض الحقول حسب نوع العرض
### عرض الجداول
* تظهر الحقول كأعمدة
* غيّر حجم الأعمدة بسحب الحدود
### عرض كانبان‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏
* تظهر الحقول على البطاقات
* أعِد الترتيب عبر الخيارات → الحقول
* استخدم العرض المضغوط لإخفاء جميع الحقول
### عروض التقويم
* تظهر الحقول المحددة في أحداث التقويم
* قم بالتهيئة عبر الخيارات → الحقول
## أفضل الممارسات
* **أظهر فقط ما يلزم** - الكثير من الحقول تفقد طريقة العرض
* **ضع الحقول المهمة أولاً** — الأعمدة الأكثر استخدامًا على اليسار
* **أنشئ عدة عروض** — مجموعات حقول مختلفة لأغراض مختلفة
* استخدم إعدادات ظهور الحقول لكل عرض — الكائن نفسه، تركيز مختلف
## ذات صلة
* [عروض الجدول](/l/ar/user-guide/views-pipelines/capabilities/table-views) — ميزات عرض القائمة
* [عروض كانبان](/l/ar/user-guide/views-pipelines/capabilities/kanban-views) — عروض قائمة على البطاقات

View File

@@ -0,0 +1,78 @@
---
title: التصفية والفرز
description: قم بتصفية السجلات وفرزها للعثور على ما تحتاج إليه بالضبط.
---
## تصفية البيانات
تساعدك عوامل التصفية على التركيز على سجلات محددة من خلال إظهار ما يطابق معاييرك فقط.
### إضافة عامل تصفية
1. انقر على زر **تصفية** في شريط الأدوات
2. اختر الحقل الذي تريد التصفية حسبه
3. اختر العامل (يساوي، يحتوي، إلخ)
4. أدخل قيمة التصفية
5. انقر على **تطبيق**
### عوامل التصفية
| نوع الحقل | العوامل المتاحة |
| ----------- | ------------------------------------- |
| نص | يساوي، يحتوي، يبدأ بـ، ينتهي بـ، فارغ |
| رقم | يساوي، أكبر من، أصغر من، فارغ |
| تاريخ | يساوي، قبل، بعد، فارغ |
| اختيار | يساوي، أي من، فارغ |
| مربع اختيار | صحيح، خطأ |
| علاقة | يساوي، فارغ |
### عوامل تصفية متعددة
اجمع بين عدة عوامل تصفية لتضييق نطاق النتائج:
* تُطبَّق جميع عوامل التصفية بمنطق AND
* كل عامل تصفية إضافي يقيِّد النتائج أكثر
### إزالة عوامل التصفية
* انقر على **X** الموجودة على كل شارة تصفية
* انقر على **مسح الكل** لإزالة جميع عوامل التصفية
## فرز البيانات
يحدّد الفرز ترتيب ظهور السجلات.
### إضافة فرز
1. انقر على زر **فرز** في شريط الأدوات
2. اختر الحقل المراد الفرز بحسبه
3. اختر تصاعديًا (A-Z, 0-9) أو تنازليًا (Z-A, 9-0)
4. انقر على **تطبيق**
### عمليات فرز متعددة
أضف مستويات فرز متعددة:
* الفرز الأول أساسي
* تُطبَّق عمليات الفرز اللاحقة ضمن مجموعات القيم المتساوية
### فرز الأعمدة السريع
انقر على أي عنوان عمود للفرز:
* النقرة الأولى: تصاعدي
* النقرة الثانية: تنازلي
* النقرة الثالثة: إزالة الفرز
## حفظ إعدادات التصفية والفرز
تُحفَظ عوامل التصفية وعمليات الفرز مع طريقة العرض:
1. قم بتهيئة عوامل التصفية وعمليات الفرز
2. انقر على **حفظ** لتحديث طريقة العرض الحالية
3. أو انقر على **حفظ كطريقة عرض جديدة** لإنشاء نسخة بديلة
## ذات صلة
* [عروض الجدول](/l/ar/user-guide/views-pipelines/capabilities/table-views) — ميزة التجميع بحسب
* [نظرة عامة على طرق العرض](/l/ar/user-guide/views-pipelines/overview) — إنشاء طرق العرض وإدارتها

View File

@@ -0,0 +1,98 @@
---
title: طرق عرض لوحة كانبان
description: تعرّف على كيفية استخدام طرق عرض كانبان لتصوّر وإدارة سير العمل لديك.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## حول عرض كانبان‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏‏.
توضح عروض كانبان التدفقات العملية بشكل مرئي، حيث يرمز كل عمود إلى مرحلة محددة وكل بطاقة تمثل سجل.
## انقل البطاقات بين المراحل
يمكنك نقل كل بطاقة بين المراحل بينما تمر عبر سير العمل الخاص بك بالنقر على البطاقة وحفظها، ثم سحبه إلى المرحلة التالية.
<VimeoEmbed videoId="927888627" title="عرض توضيحي بالفيديو" />
## إضافة المراحل وحذفها
يمكنك تصميم سير العمل الخاص بك بما يناسب احتياجاتك باستخدام المراحل، وكل منها يمثل قيمة في حقل محدد:
### إضافة المراحل
لإضافة مرحلة، الوصول إلى إعدادات الحقل المحدد عن طريق الانتقال إلى الإعدادات> نموذج البيانات، تحديد الكائن الخاص بك، ثم تحديد الحقل الخاص بك لوحة كانبان يعتمد عليه.
<VimeoEmbed videoId="927890428" title="عرض توضيحي بالفيديو" />
### إزالة مراحل
لإزالة مرحلة، مرّر مؤشر الفأرة فوق اسم المرحلة أو أيقونة `⋮`، وانقر على `تحرير من الإعدادات` في إعدادات حقل التحديد، ثم انقر على **حذف** بجوار المرحلة ذات الصلة.
## حقول العرض
يمكنك تكوين لوحة عرض كانبان لإظهار بعض الحقول وإخفاء الأخرى. لإظهار أو إخفاء الحقل، انقر فوق **خيارات** في أعلى اليمين، ثم على **الحقول** لعرض قائمة الخيارات، ثم انقر فوق أيقونة العين بجانب الحقل لإظهارها أو إخفائها.
يمكنك أيضًا إعادة ترتيب ترتيب الحقول عن طريق الضغط باستمرار على اسم الحقل وسحبه إلى المكان الذي تريده.
<img src="/images/user-guide/kanban-views/filter.png" style={{width:'100%'}} />
## عرض مضغوط
يمكنك إخفاء جميع الحقول والحصول على لمحة عامة عن جميع السجلات. للتفعيل:
1. انقر على **الخيارات** في أعلى اليمين
2. فعِّل مفتاح التبديل لخيار **العرض المضغوط**
<img src="/images/user-guide/kanban-views/compact-view.png" style={{width:'100%'}} />
## تجميعات الأعمدة
يمكن لكل عمود في طريقة عرض كانبان عرض قيم مُجمَّعة في الأعلى، مما يساعدك على فهم بياناتك بنظرة سريعة.
### التجميعات المتاحة
| التجميع | الوصف |
| ----------- | ----------------------------------- |
| **العدد** | عدد السجلات في العمود |
| **المجموع** | إجمالي حقل رقمي (مثل مبالغ الصفقات) |
| **المتوسط** | القيمة المتوسطة لحقل رقمي |
| **الأدنى** | أقل قيمة |
| **الأقصى** | أعلى قيمة |
### تكوين التجميعات
1. انقر على الرقم المعروض بجوار قيمة المرحلة، في أعلى العمود
2. اختر نوع التجميع
3. اختر الحقل المراد تجميعه
**مثال:** اعرض إجمالي قيمة الصفقات لكل مرحلة من خلال تجميع حقل Amount باستخدام المجموع.
## متى يجب استخدام طرق عرض كانبان
طرق عرض كانبان مثالية لـ:
* **مسارات المبيعات**: تتبّع الصفقات عبر المراحل من العميل المحتمل حتى الإغلاق
* **إدارة المشاريع**: راقِب المهام عبر حالات سير العمل
* **التوظيف**: تتبّع المرشحين عبر مراحل التوظيف
* **أي عملية مرحلية**: تصوّر أي سير عمل بمراحل محدّدة
## أفضل الممارسات
### نظّم مراحلَك
* **حدّد عدد المراحل**: من 5 إلى 7 مراحل مناسب للرؤية الواضحة
* **تسمية واضحة**: استخدم أسماء مراحل وصفية
* **ترتيب منطقي**: رتّب المراحل وفق ترتيب العملية
### حسّن عرض البطاقات
* **أظهر الحقول الرئيسية**: اعرض المعلومات الأهم فقط
* **استخدام عرض الاتفاق**: للملاحظات العامة الرفيعة المستوى
* **الترميز اللوني**: استخدم ألوان المراحل للتعرّف السريع على الحالة
### حافظ على جودة البيانات
* **حدّث بانتظام**: أبقِ البطاقات تتحرك عبر المراحل
* **أرشِف العناصر المكتملة**: انقل العناصر المغلقة خارج طريقة العرض النشطة
* **راجع البطاقات الراكدة**: تابِع البطاقات العالقة في المراحل

View File

@@ -0,0 +1,64 @@
---
title: عرض الجداول
description: اعرض بياناتك في تنسيق قائمة شبيه بجدول البيانات.
---
## حول عرض الجداول
تعرض طرق عرض الجدول السجلات في صفوف مع أعمدة قابلة للتخصيص—مثل جدول البيانات. هذا هو نوع العرض الافتراضي لمعظم الكائنات.
<img src="/images/user-guide/table-views/table-view.png" style={{width:'100%'}} />
## الميزات
### تكوين الأعمدة
* إظهار الأعمدة (الحقول) أو إخفاؤها
* تغيير عرض الأعمدة
* أعد ترتيب الأعمدة بالسحب
### التجميع حسب حقل من نوع اختيار
نظّم السجلات في مجموعات قابلة للطي استنادًا إلى حقل من نوع اختيار.
<img src="/images/user-guide/table-views/table-group-by.png" style={{width:'100%'}} />
1. انقر على **الخيارات**
2. اختر **التجميع**
3. اختر حقلاً من نوع اختيار
4. اضبط ترتيب المجموعات ضمن **الخيارات → التجميع → الفرز**:
* **أبجدي** أو **أبجدي معكوس**
* **ترتيب يدوي**: اسحب المجموعات تحت "المجموعات المرئية" لإعادة ترتيبها
* انقر على **أيقونة العين** بجوار مجموعة لإخفائها
**حالات الاستخدام:**
* شركات المجموعة حسب النوع
* تجميع الفرص حسب المرحلة
* تجميع المهام حسب الحالة
<Note>
**لأفضل أداء، احصرها في 10-15 مجموعة مرئية لكل عرض.** إذا كنت تحتاج إلى المزيد من المجموعات، ففكّر في استخدام لوحة المعلومات بدلاً من ذلك.
</Note>
### عرض الأعمدة
غيّر حجم الأعمدة لإظهار محتوى أكثر أو أقل:
1. ضع المؤشر بين رأسي عمودين
2. انقر واسحب حدّ العمود
3. حرّر لتعيين العرض الجديد
## متى يجب استخدام طرق عرض الجدول
تعمل طرق عرض الجدول بشكل أفضل لـ:
* **استعراض مجموعات بيانات كبيرة** — تصفّح العديد من السجلات بسرعة
* **إدخال البيانات** — تحرير سجلات متعددة بكفاءة
* **تحليل مفصّل** — عرض العديد من الحقول في آنٍ واحد
* **الفرز والتصفية** — العثور على سجلات محددة
## ذات صلة
* [الحقول والأعمدة](/l/ar/user-guide/views-pipelines/capabilities/fields-and-columns) — تكوين الحقول المراد عرضها
* [عوامل التصفية والفرز](/l/ar/user-guide/views-pipelines/capabilities/filters-and-sorting) — تضييق نطاق السجلات

View File

@@ -0,0 +1,74 @@
---
title: إعدادات العرض
description: إدارة ظهور طرق العرض وتسميتها وأيقوناتها وتنظيمها.
---
## ظهور العرض
تحكّم بمن يمكنه رؤية عروضك المخصصة.
### خيارات الظهور
| الإعداد | من يمكنه الرؤية |
| --------------- | ---------------------- |
| **مساحة العمل** | جميع أعضاء مساحة العمل |
| **غير مدرج** | أنت فقط |
### تغيير الظهور
1. افتح العرض
2. انقر على **الخيارات → الظهور**
3. اختر **مساحة العمل** أو **غير مدرج**
<Note>
لا يمكن تغيير ظهور طرق العرض الافتراضية "All [Object Name]".
</Note>
## إعادة تسمية عرض
1. افتح قائمة العرض المنسدلة
2. انقر على قائمة **⋮** بجوار العرض
3. اختر **تحرير**
4. أدخل الاسم الجديد
## تغيير أيقونة العرض
1. افتح قائمة العرض المنسدلة
2. انقر على قائمة **⋮** بجوار العرض
3. اختر **تحرير**
4. انقر على الأيقونة لتغييرها
## إعادة ترتيب طرق العرض
غيّر ترتيب ظهور العروض في القائمة المنسدلة:
1. افتح قائمة العرض المنسدلة
2. اسحب العروض من مقبضها
3. أفلِت في الموضع المطلوب
4. يتم حفظ الترتيب تلقائيًا
## تفضيل عرض
ثبّت العروض المستخدمة بكثرة للوصول السريع:
1. افتح قائمة العرض المنسدلة
2. انقر على قائمة **⋮** بجوار أحد العروض
3. اختر **إضافة إلى المفضلات**
تظهر العروض المضافة إلى المفضلات في قسم مخصص لسهولة الوصول.
## حذف عرض
1. افتح قائمة العرض المنسدلة
2. انقر على قائمة **⋮** بجوار العرض
3. اختر **حذف**
4. أكد الحذف
<Warning>
لا يمكن استعادة العروض المحذوفة.
</Warning>
## ذات صلة
* [نظرة عامة على طرق العرض](/l/ar/user-guide/views-pipelines/overview) — إنشاء طرق العرض
* [كيفية تقييد الوصول](/l/ar/user-guide/views-pipelines/how-tos/restrict-access-to-your-view) — دليل خطوة بخطوة

View File

@@ -0,0 +1,61 @@
---
title: إنشاء عرض تقويم للمهام المستحقة
description: اعرض مهامك والمواعيد النهائية على تقويم.
---
<img src="/images/user-guide/views/calendar-view-zoom.png" style={{width:'100%'}} />
## المتطلبات الأساسية
يحتاج كائن المهام إلى حقل **Due Date** (من نوع Date أو Date & Time).
## الخطوات
1. انتقل إلى **المهام**
2. انقر على القائمة المنسدلة لطريقة العرض → **+ إضافة طريقة عرض**
3. قم بتسمية العرض (مثال: "تقويم المهام")
4. انقر على **إنشاء**
5. انقر على **الخيارات** واختر **التقويم** كتخطيط
6. اختر **Due Date** كحقل التاريخ
7. انقر على **حفظ**
## تهيئة التقويم
### إظهار الحقول على الأحداث
1. انقر على **الخيارات → الحقول**
2. انقر على **أيقونة العين** لإظهار/إخفاء الحقول
3. اسحب لإعادة الترتيب
الحقول الموصى بعرضها:
* **Title** — اسم المهمة
* **Assignee** — الشخص المسؤول
* **Status** — التقدّم الحالي
### تصفية التقويم
أنشئ عروضًا مركّزة:
* **مهامي**: تصفية حسب Assignee = Me
* **هذا الأسبوع**: تصفية حسب Due Date = This week
* **متأخر**: التصفية حسب تاريخ الاستحقاق < اليوم، الحالة ≠ مكتمل
## حالات استخدام أخرى للتقويم
| كائن | حقل التاريخ | الغرض |
| --------------- | -------------- | ------------------------------- |
| الفرص | تاريخ الإغلاق | تتبع عمليات الإغلاق المتوقعة |
| الأحداث المخصصة | تاريخ الحدث | التخطيط للأنشطة |
| المشاريع | الموعد النهائي | مراقبة الجداول الزمنية للمشاريع |
## نصائح
* **راجِع أسبوعياً**: ابدأ كل أسبوع بالتحقق من عرض التقويم
* **اجمعه مع عرض الجدول**: استخدم التقويم للعرض العام، والجدول للتفاصيل
* **عيّن مستوى الرؤية**: اجعل تقاويم المهام الشخصية غير مدرجة
## ذات صلة
* [عرض التقويم](/l/ar/user-guide/views-pipelines/capabilities/calendar-view) — جميع ميزات التقويم
* [عوامل التصفية والفرز](/l/ar/user-guide/views-pipelines/capabilities/filters-and-sorting) — قم بتصفية تقويمك

View File

@@ -0,0 +1,80 @@
---
title: إنشاء عرض كانبان للمشاريع
description: تتبّع المشاريع عبر المراحل باستخدام لوحة مرئية.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
استخدم عرض كانبان لتمثيل مشاريعك بصريًا (أو أي كائن ذي مراحل) كبطاقات تتحرك عبر الأعمدة.
<VimeoEmbed videoId="927888627" title="عرض توضيحي بالفيديو" />
## المتطلبات الأساسية
يحتاج الكائن الخاص بك إلى **حقل Select** لاستخدامه كأعمدة (مثل: الحالة، المرحلة، الطور).
إذا لم يكن لديك واحد:
1. اذهب إلى **الإعدادات → نموذج البيانات**
2. اختر الكائن الخاص بك
3. أضف حقل Select مع خيارات المراحل لديك
## الخطوات
1. انتقل إلى الكائن الخاص بك (مثل: المشاريع، المهام)
2. انقر على القائمة المنسدلة لطريقة العرض → **+ إضافة طريقة عرض**
3. قم بتسمية العرض (مثال: "لوحة المشروع")
4. انقر على **إنشاء**
5. انقر على **الخيارات** واختر **كانبان** كتخطيط
6. يستخدم العرض حقل Select الخاص بك للأعمدة تلقائيًا
7. انقر على **حفظ**
## تهيئة لوحتك
### إظهار الحقول الرئيسية على البطاقات
1. انقر على **الخيارات → الحقول**
2. ابحث عن الحقول في قسم "الحقول المخفية"
3. انقر على **أيقونة العين** لعرضها على البطاقات
4. اسحب لإعادة الترتيب
<img src="/images/user-guide/kanban-views/filter.png" style={{width:'100%'}} />
### تمكين العرض المدمج
للحصول على نظرة عامة عالية المستوى:
1. انقر على **الخيارات**
2. فعِّل **العرض المضغوط**
تعرض البطاقات اسم السجل فقط.
<img src="/images/user-guide/kanban-views/compact-view.png" style={{width:'100%'}} />
### إضافة عمليات التجميع
اعرض الأعداد أو الإجماليات أعلى كل عمود:
1. انقر على الرقم بجوار اسم العمود
2. حدّد عملية التجميع (Count، Sum، إلخ)
3. اختر حقلاً إذا لزم الأمر
## نقل البطاقات
اسحب وأفلِت البطاقات بين الأعمدة لتحديث حالتها.
<VimeoEmbed videoId="927888627" title="عرض توضيحي بالفيديو" />
## مثال: لوحة المهام
| العمود (الحالة) | البطاقات |
| --------------- | ------------------ |
| **للتنفيذ** | مهام جديدة |
| **قيد التقدم** | عمل نشط |
| **مراجعة** | في انتظار الموافقة |
| **تم** | مكتمل |
## ذات صلة
* [عروض كانبان](/l/ar/user-guide/views-pipelines/capabilities/kanban-views) — عمليات التجميع، العرض المضغوط، المراحل
* [كيفية إعداد مسار مبيعات](/l/ar/user-guide/views-pipelines/how-tos/set-up-a-sales-pipeline) — كانبان للفرص

View File

@@ -0,0 +1,51 @@
---
title: إنشاء عرض الجدول مع التجميع
description: نظم سجلاتك في مجموعات قابلة للطي حسب قيمة الحقل.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
قم بتجميع عرض الجدول حسب حقل الاختيار لتنظيم السجلات في أقسام قابلة للطي.
<img src="/images/user-guide/table-views/table-group-by.png" style={{width:'100%'}} />
## الخطوات
1. انتقل إلى الكائن (الأشخاص، الشركات، إلخ)
2. انقر على القائمة المنسدلة لطريقة العرض → **+ إضافة طريقة عرض**
3. قم بتسمية العرض (مثلا: "الشركات حسب النوع")
4. انقر على **إنشاء**
5. انقر على **الخيارات → التجميع**
6. اختر حقل الاختيار للتجميع حسبه
7. انقر على **حفظ**
## تكوين ترتيب المجموعات
ضمن **الخيارات → التجميع → الفرز**، اختر كيفية ترتيب المجموعات:
| الخيار | الوصف |
| -------------- | ----------------------------------------------------- |
| **أبجدي** | من A إلى Z |
| **أبجدي عكسي** | من Z إلى A |
| **ترتيب يدوي** | اسحب المجموعات لإعادة ترتيبها ضمن "المجموعات المرئية" |
انقر على **أيقونة العين** بجانب مجموعة لإخفائها من العرض.
<Note>
**لأفضل أداء، احصر العدد في 10-15 مجموعة مرئية.** إذا احتجت إلى المزيد، فكر في استخدام لوحة المعلومات بدلا من ذلك.
</Note>
## مثال: الشركات حسب الصناعة
1. اذهب إلى **الشركات**
2. أنشئ عرضا جديدا باسم "حسب الصناعة"
3. انقر على **الخيارات → التجميع**
4. اختر حقل **الصناعة**
5. حفظ
الآن أصبحت شركاتك منظمة حسب الصناعة، مما يسهل التركيز على شريحة واحدة في كل مرة.
## ذات صلة
* [عروض الجدول](/l/ar/user-guide/views-pipelines/capabilities/table-views) — جميع ميزات عرض الجدول
* [عوامل التصفية والفرز](/l/ar/user-guide/views-pipelines/capabilities/filters-and-sorting) — اجمع بين التجميع وعوامل التصفية

View File

@@ -0,0 +1,32 @@
---
title: تقييد الوصول إلى عرضك
description: تحكّم في من يمكنه رؤية عروضك المخصّصة.
---
لكل عرض (باستثناء العروض الافتراضية "كلّ [اسم الكائن]") إعداد رؤية خاص به.
## الخطوات
1. افتح العرض الذي تريد تقييد الوصول إليه
2. انقر على **الخيارات** في الزاوية اليمنى العليا
3. انقر على **الرؤية**
4. اختر **غير مدرج**
أصبح عرضك الآن مرئيًا لك فقط.
## خيارات الرؤية
| الإعداد | من يمكنه الرؤية |
| --------------- | ---------------------- |
| **مساحة العمل** | جميع أعضاء مساحة العمل |
| **غير مدرج** | أنت فقط |
## الملاحظات
* لا يمكن جعل العروض الافتراضية "كلّ [اسم الكائن]" غير مدرجة
* لا تظهر العروض غير المدرجة في القوائم المنسدلة للعروض لدى المستخدمين الآخرين
* يمكنك تغيير الرؤية للعودة إلى مساحة العمل في أي وقت
## ذات صلة
* [إعدادات العرض](/l/ar/user-guide/views-pipelines/capabilities/view-settings) — جميع خيارات إعداد العرض

View File

@@ -0,0 +1,120 @@
---
title: إعداد مسار المبيعات
description: قم بتهيئة مسار المبيعات لديك لتتبّع الفرص عبر المراحل.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
يمثّل مسار المبيعات في Twenty عرض كانبان لكائن الفرص لديك، حيث يمثّل كل عمود مرحلة في عملية المبيعات الخاصة بك.
## الخطوة 1: تهيئة المراحل الخاصة بك
تُحدَّد المراحل في حقل **Stage** الخاص بكائن الفرص.
1. اذهب إلى **الإعدادات → نموذج البيانات**
2. حدّد **الفرص**
3. ابحث عن حقل **Stage** وانقر عليه
4. أضِف المراحل أو أزلها أو أعد تسميتها بما يتوافق مع عمليتك
<VimeoEmbed videoId="927890428" title="عرض توضيحي بالفيديو" />
### المراحل الموصى بها
| المرحلة | الغرض |
| ----------------- | ----------------------------- |
| **جديد** | فرص جديدة تم تحديدها للتو |
| **مؤهل** | تم التأكّد من ملاءمتها الجيدة |
| **اجتماع** | تجري مناقشات |
| **عرض** | تم إرسال العرض |
| **تفاوض** | جارٍ العمل على الشروط |
| **مغلقة - رابحة** | صفقة ناجحة |
| **مغلقة - خاسرة** | صفقة غير ناجحة |
<Note>
**5-7 المراحل مثلى.** مراحل كثيرة جدا تجعل من الصعب مسح خط الأنابيب، وقلة قليلة جدا تفقد الرؤية في إحراز التقدم.
</Note>
## الخطوة 2: إنشاء عرض لمسار المبيعات
1. اذهب إلى **الفرص**
2. انقر على القائمة المنسدلة لطريقة العرض → **+ إضافة طريقة عرض**
3. سمِّه "مسار المبيعات"
4. انقر على **إنشاء**
5. افتح **الخيارات** واختر **Kanban** كتخطيط
يستخدم العرض تلقائيًا حقل Stage للأعمدة.
## الخطوة 3: تهيئة العرض الخاص بك
### إظهار الحقول الرئيسية
1. انقر على **الخيارات → الحقول**
2. ابحث عن الحقول في قسم "الحقول المخفية"
3. انقر على **أيقونة العين** لعرض: Company، Amount، Close Date، Owner
### تمكين عمليات التجميع
إظهار الإجماليات أعلى كل عمود:
1. انقر على الرقم المعروض بجانب اسم Stage أعلى العمود
2. حدّد نوع التجميع (Count، Sum، Average، إلخ)
3. اختر الحقل المراد تجميعه (مثال: Amount)
**مثال:** اعرض إجمالي قيمة الصفقات لكل مرحلة من خلال تجميع حقل Amount باستخدام المجموع.
### استخدام طريقة العرض المدمجة (اختياري)
للحصول على نظرة عامة عالية المستوى مع أدنى قدر من محتوى البطاقات:
1. انقر على **الخيارات**
2. فعِّل مفتاح التبديل لخيار **العرض المضغوط**
## الخطوة 4: إنشاء عروض شخصية وعروض للفريق
### "مسار المبيعات الخاص بي"
* **عامل التصفية**: Owner = Me
* **الظهور**: غير مُدرَج (عرض شخصي)
### "مسار المبيعات للفريق"
* **عامل التصفية**: None (عرض الكل)
* **الظهور**: Workspace (عرض مشترك)
### "الإغلاق هذا الشهر"
* **النوع**: Table
* **عامل التصفية**: Close Date = This month، Stage ≠ Closed Won، Stage ≠ Closed Lost
* **الفرز**: Close Date تصاعديًا
## العمل مع الفرص
### إنشاء الفرص
* انقر على **+ New** في عرض الفرص
* أو انقر على **+** في عمود مرحلة معيّنة
### الانتقال عبر المراحل
اسحب وأفلِت بطاقات الفرص بين الأعمدة لتحديث مرحلتها.
<VimeoEmbed videoId="927888627" title="عرض توضيحي بالفيديو" />
## أفضل الممارسات
### نظافة مسار المبيعات
* حدِّث الصفقات يوميًا مع تقدّمها
* انقل الصفقات الراكدة أو أغلِقها على الفور
* اجعل تواريخ الإقفال واقعية
### الانضباط في المراحل
* حدِّد معايير واضحة لكل مرحلة
* انقل الصفقات فور استيفاء المعايير
* لا تدَع الصفقات تبقى في المراحل لوقت طويل
## ذات صلة
* [عروض كانبان](/l/ar/user-guide/views-pipelines/capabilities/kanban-views) — عمليات التجميع والعرض المضغوط
* [عوامل التصفية والفرز](/l/ar/user-guide/views-pipelines/capabilities/filters-and-sorting) — إنشاء عروض مُفلترة

View File

@@ -0,0 +1,149 @@
---
title: إظهار المبلغ المتوقع في خط الأنابيب
description: احسب واعرض قيم الصفقات الموزونة استنادًا إلى احتمال المرحلة.
---
المبلغ المتوقع هو قيمة محسوبة: **المبلغ × الاحتمال**. يساعدك هذا على توقّع الإيرادات من خلال وزن الصفقات بناءً على مدى احتمالية إغلاقها.
<Tip>
هذا مثال على إنشاء [حقول الصيغ](/l/ar/user-guide/workflows/how-tos/crm-automations/formula-fields) باستخدام سير العمل.
</Tip>
يرشدك هذا الدليل إلى إعداد الحقول المخصصة وسير العمل اللازمة لحساب المبالغ المتوقعة وعرضها في خط سير المبيعات لديك.
## الخطوة 1: إنشاء حقول مخصصة
تحتاج إلى حقلين مخصصين على كائن «الفرص».
### إنشاء حقل الاحتمال
1. انتقل إلى **الإعدادات → نموذج البيانات → الفرص**
2. انقر **+ إضافة حقل**
3. التكوين:
* **الاسم**: الاحتمال
* **النوع**: رقم
* **الوصف**: احتمال قائم على المرحلة (0-100%)
4. انقر على **حفظ**
### إنشاء حقل المبلغ المتوقع
1. انقر **+ إضافة حقل**
2. التكوين:
* **الاسم**: المبلغ المتوقع
* **النوع**: عملة
* **الوصف**: محسوب: المبلغ × الاحتمال
3. انقر على **حفظ**
### اختياري: جعل الحقول للقراءة فقط للمستخدمين
إذا كنت لا تريد أن يحرّر المستخدمون هذه الحقول المحسوبة يدويًا:
1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. حدِّد الدور لتكوينه
3. اعثر على كائن «الفرص»
4. عيّن حقلي **الاحتمال** و**المبلغ المتوقع** كحقول للقراءة فقط
يضمن هذا أن يتم تحديث هذه القيم عبر «سير العمل» فقط.
## الخطوة 2: إنشاء سير العمل رقم 1 — تحديث الاحتمال عند تغيير المرحلة
يضبط سير العمل هذا «الاحتمال» تلقائيًا عند انتقال فرصة إلى مرحلة جديدة.
### إنشاء سير العمل
1. انتقل إلى **سير العمل**
2. انقر **+ سير عمل جديد**
3. سمِّه "تحديث الاحتمال عند تغيير المرحلة"
### تكوين المشغّل
1. أضِف مشغّل **إنشاء أو تحديث سجل**
2. حدِّد **الفرص** على أنه الكائن
3. التصفية على: تم تحديث حقل **المرحلة**
### أضِف تفرعات لكل مرحلة
أنشئ تفرعًا لكل مرحلة مع احتمالها:
| المرحلة | الاحتمال |
| ------------------ | -------- |
| جديد | 10% |
| مؤهل | 25% |
| اجتماع | 40% |
| العرض | 60% |
| تفاوض | 80% |
| تم الإغلاق - ربح | 100% |
| تم الإغلاق - خسارة | 0% |
<Note>
لإنشاء تفرع جديد، انقر بزر الماوس الأيمن على لوحة سير العمل وانقر **إجراء جديد**. بعد ذلك، اربط هذا الإجراء بالعقدة السابقة عبر سحب السهم من العقدة السابقة إلى هذا الإجراء الجديد.
</Note>
لكل مرحلة:
1. أضِف عقدة **تصفية**: المرحلة = [اسم المرحلة]
2. أضِف إجراء **تحديث سجل**:
* السجل: الفرصة المُشغِّلة
* الحقل: الاحتمال
* القيمة: [احتمال تلك المرحلة]
### حساب المبلغ المتوقع
بعد انضمام التفرعات مجددًا:
1. أضِف عقدة **تصفية**: المبلغ غير فارغ
2. أضِف إجراء **تحديث سجل**:
* السجل: الفرصة المُشغِّلة
* الحقل: المبلغ المتوقع
* القيمة: المبلغ × الاحتمال
## الخطوة 3: إنشاء سير العمل رقم 2 — إعادة الحساب عند تغيير المبلغ
يحدّث سير العمل هذا «المبلغ المتوقع» عند تغيّر «مبلغ الصفقة».
### إنشاء سير العمل
1. انتقل إلى **سير العمل**
2. انقر **+ سير عمل جديد**
3. سمِّه "إعادة حساب المبلغ المتوقع عند تغيير المبلغ"
### تكوين المشغّل
1. أضِف مشغّل **إنشاء أو تحديث سجل**
2. حدِّد **الفرص** على أنه الكائن
3. التصفية على: تم تحديث حقل **المبلغ**
### إضافة المنطق
1. أضِف عقدة **تصفية**: المبلغ غير فارغ
2. أضِف إجراء **تحديث سجل**:
* السجل: الفرصة المُشغِّلة
* الحقل: المبلغ المتوقع
* القيمة: المبلغ × الاحتمال
## الخطوة 4: العرض في خط سير المبيعات لديك
اعرض الآن إجماليات «المبلغ المتوقع» في طريقة عرض كانبان لديك:
1. افتح طريقة عرض كانبان **خط سير المبيعات**
2. انقر **الرقم** الموجود بجوار أي اسم مرحلة أعلى العمود
3. اختر **المجموع**
4. اختر **المبلغ المتوقع**
سيعرض كل عمود الآن إجمالي القيمة الموزونة في خط السير لتلك المرحلة.
## ملخص
| المكوّن | الغرض |
| ---------------------- | ----------------------------------------------------------------- |
| **حقل الاحتمال** | يخزّن احتمال الفوز القائم على المرحلة |
| **حقل المبلغ المتوقع** | يخزّن المبلغ × الاحتمال |
| **سير العمل رقم 1** | يحدّث «الاحتمال» عند تغيير المرحلة، ثم يعيد حساب «المبلغ المتوقع» |
| **سير العمل رقم 2** | يعيد حساب «المبلغ المتوقع» عند تغيير «المبلغ» |
| **التجميع** | يعرض مجموع «المبلغ المتوقع» لكل مرحلة |
## ذات صلة
* [حقول الصيغ](/l/ar/user-guide/workflows/how-tos/crm-automations/formula-fields) — إنشاء حقول محسوبة باستخدام سير العمل
* [طرق عرض كانبان](/l/ar/user-guide/views-pipelines/capabilities/kanban-views) — تجميعات الأعمدة
* [كيفية إنشاء حقول مخصصة](/l/ar/user-guide/data-model/how-tos/create-custom-fields) — تكوين الحقول

View File

@@ -0,0 +1,231 @@
---
title: تتبّع مدة بقاء الفرص في كل مرحلة
description: راقِب سرعة الصفقات بتتبُّع وقت دخول الفرص إلى كل مرحلة.
---
<Tip>
هذا مثال على إنشاء [حقول الصيغة](/l/ar/user-guide/workflows/how-tos/crm-automations/formula-fields) باستخدام سير العمل — وتحديدًا حسابات التواريخ.
</Tip>
يساعدك تتبُّع وقت دخول الفرص إلى كل مرحلة على تحديد نقاط الاختناق وقياس سرعة الصفقات.
يرشدك هذا الدليل إلى إعداد حقول مخصّصة وسير عمل لتسجيل وقت انتقال الفرصة إلى كل مرحلة تلقائيًا، وحساب عدد الأيام التي أمضتها في المرحلة السابقة.
## الخطوة 1: إنشاء حقول مخصّصة
تحتاج إلى نوعين من الحقول لكل مرحلة:
* **حقول التاريخ والوقت**: تسجيل وقت دخول الفرصة إلى كل مرحلة
* **حقول الأرقام**: تخزين عدد الأيام التي أمضتها الفرصة في كل مرحلة
### إنشاء حقول "آخر دخول"
1. انتقل إلى **الإعدادات → نموذج البيانات → الفرص**
2. لكل مرحلة، انقر **+ إضافة حقل** وقم بالتهيئة:
* **الاسم**: آخر دخول [اسم المرحلة] (مثال: "آخر دخول جديد"، "آخر دخول مؤهّل")
* **النوع**: تاريخ ووقت
* **الوصف**: الطابع الزمني عند دخول الفرصة هذه المرحلة
3. انقر على **حفظ**
أنشئ هذه الحقول:
* آخر دخول جديد
* آخر دخول مؤهّل
* آخر دخول اجتماع
* آخر دخول عرض
* آخر دخول تفاوض
* آخر دخول مغلقة - ربح
* آخر دخول مغلقة - خسارة
### إنشاء حقول "الأيام في المرحلة"
1. لكل مرحلة، انقر **+ إضافة حقل** وقم بالتهيئة:
* **الاسم**: الأيام في [اسم المرحلة] (مثال: "الأيام في جديد"، "الأيام في مؤهّل")
* **النوع**: رقم
* **الوصف**: عدد الأيام المقضية في هذه المرحلة
2. انقر على **حفظ**
أنشئ هذه الحقول:
* الأيام في جديد
* الأيام في مؤهّل
* الأيام في اجتماع
* الأيام في عرض
* الأيام في تفاوض
<Note>
لا تحتاج إلى حقول "الأيام في" لمرحلتي "مغلقة - ربح" و"مغلقة - خسارة" لأنها مراحل نهائية.
</Note>
### اختياري: جعل الحقول للقراءة فقط
إذا كنت لا تريد أن يحرّر المستخدمون هذه الحقول المحسوبة يدويًا:
1. انتقل إلى **الإعدادات → الأعضاء → الأدوار**
2. حدِّد الدور لتهيئته
3. اعثر على كائن الفرص
4. عيِّن حقول "آخر دخول" و"الأيام في" كحقول للقراءة فقط
## الخطوة 2: إنشاء سير العمل
يتولّى سير العمل الواحد هذا المهمتين معًا:
* يسجّل الطابع الزمني عند الدخول إلى مرحلة جديدة
* يحسب الأيام المُستغرَقة في المرحلة السابقة
### إنشاء سير العمل
1. انتقل إلى **سير العمل**
2. انقر **+ سير عمل جديد**
3. سمِّه "تتبُّع وقت المرحلة"
### تهيئة المشغِّل
1. أضِف مشغِّل **تحديث السجل**
2. حدِّد **الفرص** ككائن
3. التصفية على: تم تحديث حقل **المرحلة**
### إضافة تفرّعات لكل مرحلة
<Note>
لإنشاء تفرّع جديد، انقر بزر الفأرة الأيمن على لوحة سير العمل ثم انقر **إجراء جديد**. بعد ذلك، اربط هذا الإجراء بالعُقدة السابقة بسحب السهم من العُقدة السابقة إلى هذا الإجراء الجديد.
</Note>
---
**التفرّع 1: المرحلة = جديد (المرحلة الأولى)**
نظرًا لأنها المرحلة الأولى، يتم تسجيل الطابع الزمني للدخول فقط — لا توجد مرحلة سابقة يمكن الاحتساب بناءً عليها.
1. أضِف عُقدة **تصفية**: المرحلة = جديد
2. أضِف إجراء **كود**:
```javascript
export const main = async (): Promise<object> => {
return { now: new Date().toISOString() };
};
```
3. أضِف إجراء **تحديث سجل**:
* السجل: الفرصة المُشغِّلة
* الحقل: آخر دخول جديد
* القيمة: `now` من عُقدة الكود
---
**التفرّع 2: المرحلة = مؤهّل**
عند الانتقال إلى مرحلة مؤهّل، سجّل وقت الدخول واحسب أيضًا الأيام التي أمضتها في مرحلة جديد.
1. أضِف عُقدة **تصفية**: المرحلة = مؤهّل
2. أضِف إجراء **كود**:
```javascript
export const main = async (params: {
lastEnteredPreviousStage: Date;
}): Promise<object> => {
const { lastEnteredPreviousStage } = params;
const now = new Date();
const entryDate = new Date(lastEnteredPreviousStage);
const diffTime = Math.abs(now.getTime() - entryDate.getTime());
const daysInPreviousStage = Math.ceil(diffTime / (1000 * 60 * 60 * 24));
return {
now: now.toISOString(),
daysInPreviousStage: daysInPreviousStage
};
};
```
3. اضبط مُدخلات عُقدة الكود: اربط `lastEnteredPreviousStage` بحقل **آخر دخول جديد**
4. أضِف إجراء **تحديث سجل**:
* السجل: الفرصة المُشغِّلة
* الحقول المطلوب تحديثها:
* آخر دخول مؤهّل = `now`
* الأيام في جديد = `daysInPreviousStage`
---
**التفرّع 3: المرحلة = اجتماع**
عند الانتقال إلى مرحلة اجتماع، سجّل وقت الدخول واحسب أيضًا الأيام التي أمضتها في مرحلة مؤهّل.
1. أضِف عُقدة **تصفية**: المرحلة = اجتماع
2. أضِف إجراء **كود**:
```javascript
export const main = async (params: {
lastEnteredPreviousStage: Date;
}): Promise<object> => {
const { lastEnteredPreviousStage } = params;
const now = new Date();
const entryDate = new Date(lastEnteredPreviousStage);
const diffTime = Math.abs(now.getTime() - entryDate.getTime());
const daysInPreviousStage = Math.ceil(diffTime / (1000 * 60 * 60 * 24));
return {
now: now.toISOString(),
daysInPreviousStage: daysInPreviousStage
};
};
```
3. اضبط مُدخلات عُقدة الكود: اربط `lastEnteredPreviousStage` بحقل **آخر دخول مؤهّل**
4. أضِف إجراء **تحديث سجل**:
* السجل: الفرصة المُشغِّلة
* الحقول المطلوب تحديثها:
* آخر دخول اجتماع = `now`
* الأيام في مؤهّل = `daysInPreviousStage`
---
**تابِع لبقية المراحل:**
| المرحلة | السجلات | يحسب |
| ------------- | ---------------------- | ---------------- |
| عرض | آخر دخول عرض | الأيام في اجتماع |
| تفاوض | آخر دخول تفاوض | الأيام في عرض |
| مغلقة - ربح | آخر دخول مغلقة - ربح | الأيام في تفاوض |
| مغلقة - خسارة | آخر دخول مغلقة - خسارة | الأيام في تفاوض |
لا حاجة لعودة التفرّعات للاندماج—فكل واحد يعمل بشكل مستقل عند تحقق شرط مرحلته.
## الخطوة 3: تحليل الوقت في المرحلة
مع تسجيل الطوابع الزمنية وعدّ الأيام، يمكنك الآن تحليل سرعة الصفقات.
### إنشاء عرض "صفقات بطيئة"
1. أنشئ عرض جدول للفرص
2. أضِف أعمدة: الاسم، المرحلة، الأيام في [المرحلة السابقة]، المبلغ
3. رتِّب حسب حقل "الأيام في" (تنازليًا)
4. رشِّح حسب المرحلة للتركيز على مرحلة واحدة في كل مرة
الصفقات في الأعلى أمضت أطول وقت في المرحلة السابقة.
### استخدم التجميعات
في عرض كانبان لمسار الصفقات لديك:
1. انقر الرقم بجانب اسم مرحلة
2. حدِّد **المتوسط**
3. اختر حقل "الأيام في"
سيُظهر هذا متوسط الوقت الذي تمضيه الصفقات في كل مرحلة.
## ملخص
| المكوِّن | الغرض |
| --------------------- | ---------------------------------------------- |
| **حقول آخر دخول** | تخزين وقت دخول الفرصة إلى كل مرحلة |
| **حقول الأيام في** | تخزين عدد الأيام المقضية في كل مرحلة |
| **سير العمل** | يسجّل الطابع الزمني ويحسب الأيام في خطوة واحدة |
| **العروض والتجميعات** | تحليل سرعة الصفقات وتحديد نقاط الاختناق |
## ذات صلة
* [سير العمل](/l/ar/user-guide/workflows/overview) — أساسيات الأتمتة
* [كيفية إنشاء حقول مخصّصة](/l/ar/user-guide/data-model/how-tos/create-custom-fields) — تهيئة الحقول
* [عروض كانبان](/l/ar/user-guide/views-pipelines/capabilities/kanban-views) — التجميعات

View File

@@ -0,0 +1,132 @@
---
title: العروض والمسارات
description: تعرّف على كيفية إنشاء العروض وإدارتها في Twenty.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## فهم العروض
العروض هي إعدادات محفوظة تحدد كيفية عرض بياناتك. يمكن أن يتضمن كل عرض ما يلي:
* **التخطيط**: جدول، كانبان، أو تقويم
* **عوامل التصفية**: تحديد السجلات التي سيتم عرضها
* **الفرز**: كيفية ترتيب السجلات
* **الحقول**: الأعمدة المرئية
## أنواع العروض
### عرض الجدول
عرض افتراضي يشبه جداول البيانات، يعرض السجلات في صفوف مع أعمدة قابلة للتخصيص.
### عرض كانبان
عرض لوحة بصري تظهر فيه السجلات كبطاقات منظَّمة حسب المراحل. مثالي لـ:
* مسارات المبيعات
* تتبع المشاريع
* أي سير عمل بمراحل محددة
### عرض التقويم
عرض تقويم يعرض السجلات التي تحتوي على حقول تاريخ. مثالي لـ:
* الاجتماعات والفعاليات
* المواعيد النهائية وتواريخ الاستحقاق
* التخطيط القائم على الوقت
## إنشاء طريقة عرض.
هناك طريقتان لإنشاء عرض جديد.
### استخدام قائمة العرض المنسدلة
1. انتقل إلى أي كائن (الأشخاص، الشركات، إلخ)
2. انقر على اسم العرض في أعلى اليسار (يُظهر العرض الحالي مع سهم منسدل)
3. انقر على **+ إضافة عرض**
4. قم بتسمية العرض ثم انقر على **إنشاء**
5. اختر تخطيطًا (جدول، كانبان، أو تقويم) من ضمن **الخيارات**
6. أضف عوامل التصفية والفرز حسب الحاجة
7. حدد الحقول التي سيتم عرضها وأعد ترتيبها
8. انقر على **حفظ**
<VimeoEmbed videoId="1145648745" title="عرض توضيحي بالفيديو" />
### ابدأ بتحرير عرض موجود حاليًا
1. انتقل إلى أي كائن (الأشخاص، الشركات، إلخ)
2. اختر تخطيطًا (جدول، كانبان، أو تقويم) ضمن **Options**، وأضف عوامل التصفية والفرز حسب الحاجة
3. انقر على **حفظ كعرض جديد**
4. قم بتسمية العرض ثم انقر على **إنشاء**
5. واصل تحرير عرضك الجديد
6. انقر على **تحديث العرض** لحفظ الإعدادات الإضافية
<VimeoEmbed videoId="1145654005" title="عرض توضيحي بالفيديو" />
## إدارة العروض
### تحرير عرض
1. اختر العرض من القائمة المنسدلة
2. أجرِ التغييرات الخاصة بك (عوامل التصفية، الفرز، الأعمدة)
3. انقر على **حفظ** لتحديث العرض
### إعادة تسمية عرض أو تغيير أيقونته
1. افتح قائمة العرض المنسدلة
2. انقر على قائمة **⋮** بجانب اسم العرض
3. اختر **تحرير**
4. غيّر الاسم أو الأيقونة
5. انقر على **حفظ**
### إعادة ترتيب العروض
1. افتح قائمة العرض المنسدلة
2. انقر واسحب عرضًا من مقبضه
3. أسقطه في الموضع المطلوب
4. يتم حفظ الترتيب الجديد تلقائيًا
### إضافة إلى المفضلات
ثبّت العروض المستخدمة بشكل متكرر للوصول السريع:
1. افتح قائمة العرض المنسدلة
2. انقر على قائمة **⋮** بجانب أحد العروض
3. اختر **إضافة إلى المفضلات**
4. سيظهر العرض في قسم المفضلات لديك
### حذف عرض
1. اختر العرض المراد حذفه
2. انقر على قائمة العرض المنسدلة
3. انقر على قائمة **⋮** بجانب العرض
4. اختر **حذف**
5. أكد الحذف
<Warning>
لا يمكن استعادة العروض المحذوفة. تأكد من رغبتك في إزالته قبل التأكيد.
</Warning>
## ظهور العرض
لكل عرض (باستثناء عروض "كل [اسم الكائن]" الافتراضية) إعداد ظهور خاص به.
لتغيير الظهور:
1. افتح العرض
2. انقر على **الخيارات → الظهور**
3. اختر:
* **مساحة العمل**: مرئي لجميع أعضاء مساحة العمل
* **غير مدرج**: مرئي لك فقط
<Note>
لا يمكن تغيير ظهور عروض "كل [اسم الكائن]" الافتراضية.
</Note>
## الخطوات التالية
* [عروض الجداول](/l/ar/user-guide/views-pipelines/capabilities/table-views)
* [عروض كانبان](/l/ar/user-guide/views-pipelines/capabilities/kanban-views)
* [عوامل التصفية والفرز](/l/ar/user-guide/views-pipelines/capabilities/filters-and-sorting)
* [إعدادات العرض](/l/ar/user-guide/views-pipelines/capabilities/view-settings)

View File

@@ -0,0 +1,167 @@
---
title: إرسال رسائل البريد الإلكتروني عبر سير العمل
description: أرسل رسائل بريد إلكتروني مُخصّصة تلقائياً باستخدام إجراءات سير العمل.
---
أرسل رسائل البريد الإلكتروني تلقائياً عند حدوث أحداث معيّنة في نظام إدارة علاقات العملاء (CRM) لديك—رحّب بجهات الاتصال الجديدة، وتابع الفرص، أو أخطر أعضاء الفريق.
## المتطلبات الأساسية
قبل أن تتمكن من إرسال رسائل البريد الإلكتروني من سير العمل:
1. وصّل حساب بريد إلكتروني ضمن **الإعدادات → الحسابات**
2. تأكد من أن الحساب لديه أذونات إرسال مفعّلة
## سير عمل أساسي للبريد الإلكتروني
### مثال: رسالة ترحيب لجهات الاتصال الجديدة
**الهدف**: إرسال رسالة ترحيب عند إضافة شخص جديد إلى نظام إدارة علاقات العملاء (CRM).
**الإعداد**:
1. **إنشاء سير عمل**: انتقل إلى **الإعدادات → سير العمل** ثم انقر **+ سير عمل جديد**
2. **إضافة مشغّل**: اختر **تم إنشاء سجل** → **الأشخاص**
3. **إضافة إجراء إرسال بريد إلكتروني**:
* انقر **+** لإضافة إجراء
* اختر **إرسال بريد إلكتروني**
* قم بتهيئة البريد الإلكتروني:
| الحقل | القيمة |
| ----------- | -------------------------------------- |
| **إلى** | `{{trigger.object.email}}` |
| **الموضوع** | `مرحبا بك في {{Your Company Name}}` |
| **المحتوى** | `Hi {{trigger.object.firstName}}, ...` |
4. **الاختبار والتفعيل**: اختبر باستخدام سجل عينة، ثم فعِّل
## استخدام المتغيرات في رسائل البريد الإلكتروني
استدعِ البيانات من الخطوات السابقة باستخدام صيغة `{{variable}}`:
```text
Hi {{trigger.object.firstName}},
Thank you for connecting with us!
Your company, {{trigger.object.company.name}}, is now in our system.
Best regards,
The Team
```
### المتغيرات المتاحة من المشغّلات
| نوع المُحفِز | المتغيرات الشائعة |
| ------------------------ | -------------------------------------- |
| **تم إنشاء/تحديث السجل** | `{{trigger.object.fieldName}}` |
| **يدوي** | `{{trigger.selectedRecord.fieldName}}` |
| **الويب هوك** | `{{trigger.body.fieldName}}` |
## متقدم: رسائل بريد إلكتروني مشروطة
### مثال: رسائل بريد إلكتروني مختلفة بناءً على مصدر العميل المحتمل
**الهدف**: إرسال رسائل ترحيب مختلفة بناءً على مصدر قدوم العميل المحتمل.
**الإعداد**:
1. **المشغّل**: تم إنشاء سجل (الأشخاص)
2. **إضافة إجراء تصفية**:
* الشرط: `{{trigger.object.source}}` يساوي `"Website"`
* إذا كان صحيحاً → المتابعة إلى رسالة الترحيب الخاصة بالموقع الإلكتروني
3. **فرع للمصادر الأخرى**:
* أنشئ فروعاً متوازية لمصادر مختلفة
* لكل فرع إجراء إرسال بريد إلكتروني خاص به
## إرسال رسائل البريد الإلكتروني إلى عدة مستلمين
### مثال: إشعار الفريق عند إغلاق الصفقة
**الهدف**: إرسال بريد إلكتروني إلى مندوب المبيعات ومديره عند ربح فرصة.
**الإعداد**:
1. **المشغّل**: تم تحديث السجل (الفرص، المرحلة = "Closed Won")
2. **البحث في السجلات**: اعثر على مدير مالك الفرصة
3. **إرسال بريد إلكتروني #1**: إلى مالك الفرصة
* إلى: `{{trigger.object.owner.email}}`
* الموضوع: `تهانينا على إغلاق {{trigger.object.name}}!`
4. **إرسال بريد إلكتروني #2**: إلى المدير
* إلى: `{{searchRecords.manager.email}}`
* الموضوع: `تم ربح الصفقة: {{trigger.object.name}}`
## رسائل متابعة مجدولة
### مثال: متابعة بعد 3 أيام من الاجتماع
**الهدف**: إرسال رسالة متابعة عبر البريد الإلكتروني بعد 3 أيام من تسجيل اجتماع.
**الإعداد**:
1. **المشغّل**: تم إنشاء سجل (الأنشطة، النوع = "اجتماع")
2. **إجراء تأخير**: الانتظار 3 أيام
3. **إرسال البريد الإلكتروني**:
* إلى: مشارك الاجتماع
* الموضوع: متابعة لمحادثتنا
* المحتوى: الإشارة إلى تفاصيل الاجتماع من المشغّل
## مرفقات البريد الإلكتروني
يمكنك إرفاق ملفات برسائل البريد الإلكتروني المرسلة من سير العمل. المرفق ملف ثابت تقوم برفعه عند تهيئة سير العمل.
### كيفية إضافة مرفق
1. في إجراء **إرسال بريد إلكتروني**، انقر على زر **المرفقات**
2. انقر لرفع ملف من جهازك
3. سيتم إرفاق الملف بجميع رسائل البريد الإلكتروني التي يرسلها هذا الإجراء
### الاستخدامات الشائعة
| حالة الاستخدام | ملف نموذجي |
| --------------------------------------- | -------------------------------- |
| **رسائل الترحيب عبر البريد الإلكتروني** | كتيب الشركة (PDF) |
| **تسلسلات الانضمام** | دليل البدء |
| **متابعات المبيعات** | كتالوج المنتجات أو قائمة الأسعار |
| **تأكيدات الفعاليات** | تفاصيل الفعالية أو جدول الأعمال |
<Note>
المرفقات ثابتة—يتم إرسال الملف نفسه إلى جميع المستلمين. بالنسبة للمستندات الديناميكية (مثل عروض الأسعار المخصصة)، أنشئ الملفات وأرفقها باستخدام [وظيفة منطقية](/l/ar/user-guide/workflows/how-tos/connect-to-other-tools/generate-pdf-from-twenty).
</Note>
## أفضل الممارسات
### محتوى البريد الإلكتروني
* اجعل سطور الموضوع موجزة وذات صلة
* خصص الرسالة باسم المستلم
* ضمّن دعوة واضحة للإجراء
* اختبر رسائل البريد الإلكتروني قبل التفعيل
### قابلية التسليم
* لا ترسل عدداً كبيراً من الرسائل بسرعة كبيرة
* استخدم تواقيع بريد إلكتروني احترافية
* تجنب كلمات تُحفّز مرشحات البريد العشوائي
* احرص على توفير خيارات إلغاء الاشتراك لرسائل التسويق الإلكترونية
### استكشاف الأخطاء وإصلاحها
* تحقّق من أن حساب البريد الإلكتروني متصل وفعّال
* تحقّق من صحة عنوان البريد الإلكتروني للمستلم
* راجِع عمليات تشغيل سير العمل بحثاً عن رسائل الخطأ
* اختبر باستخدام عنوان بريدك الإلكتروني أولاً
## ذات صلة
* [مشغلات سير العمل](/l/ar/user-guide/workflows/capabilities/workflow-triggers)
* [إجراءات سير العمل](/l/ar/user-guide/workflows/capabilities/workflow-actions)

View File

@@ -0,0 +1,88 @@
---
title: استخدام الفروع في سير العمل
description: افهم كيف تعمل الفروع وكيف تتحكم في المسار الذي يتم تنفيذه.
---
## كيف تعمل الفروع
في محرر سير العمل، يمكنك إنشاء مسارات متعددة (فروع) تنطلق من عقدة واحدة. يُمكّنك هذا من إنشاء أتمتة معقدة بنتائج مختلفة.
**مهم**: عند تشغيل سير العمل، **تُنفَّذ جميع الفروع بالتوازي افتراضيًا**. لا توجد بنية منطقية مدمجة "if/else" لاختيار فرع على آخر — كل مسار سيعمل في الوقت نفسه.
## التحكم في الفرع الذي يعمل
لتنفيذ فرع واحد فقط بناءً على شروط محددة، **أضِف عقدة Filter في بداية كل فرع**.
### مثال على الإعداد
1. أنشئ سير العمل الخاص بك بفروع متعددة من عقدة واحدة
2. أضِف عقدة **Filter** كأول خطوة في كل فرع
3. عيِّن شروطًا على كل Filter لتحديد متى يجب أن يواصل ذلك الفرع
4. سيتابع فقط الفرع أو الفروع التي تستوفي شروط Filter
### كيف تعمل عُقد Filter
* إذا كان شرط Filter **متحققًا**: يتابع الفرع التنفيذ
* إذا كان شرط Filter **غير متحقق**: يتوقف الفرع عند عقدة Filter
يُنشئ هذا عمليًا منطقًا شرطيًا بحيث لا يعمل إلا الفرع المناسب بناءً على بياناتك.
## مثال: التوجيه حسب حجم الصفقة
**السيناريو**: عند إغلاق صفقة، أرسِل إشعارات مختلفة حسب حجم الصفقة.
1. **المشغّل**: تم تحديث الفرصة (المرحلة = Closed Won)
2. **الفرع 1**: شرط Filter للمبلغ > $10,000 → إرسال رسالة Slack إلى #big-deals
3. **الفرع 2**: شرط Filter للمبلغ ≤ $10,000 → إرسال بريد إلكتروني إلى مدير المبيعات
يبدأ الفرعان، لكن الفرع الذي يطابق مبلغ الصفقة فقط سيستمر بعد عقدة Filter.
## إنشاء الفروع
<Note>
لإنشاء فرع جديد من خطوة موجودة، انقر زر **+** على الخطوة وأضِف الإجراء الخاص بك. يمكنك إضافة عدة فروع بالنقر على **+** عدة مرات.
</Note>
1. في محرر سير العمل، حدِّد الخطوة التي تريد التفريع منها
2. انقر **+** لإضافة إجراء
3. سيؤدي هذا إلى إنشاء فرع واحد
4. انقر **+** مرة أخرى على نفس الخطوة لإنشاء فروع إضافية
5. يمكن لكل فرع أن يكون له تسلسل إجراءات خاص به
## دمج الفروع معًا مرة أخرى
بعد أن تُكمل الفروع المتوازية عملها، يمكنك دمجها مرة أخرى في مسار واحد:
1. أكمل إجراءات الفروع
2. أضِف خطوة جديدة ينبغي أن تعمل بعد جميع الفروع
3. اسحب اتصالًا من الخطوة الأخيرة لكل فرع إلى هذه الخطوة الجديدة
4. تنتظر الخطوة المدمجة اكتمال جميع الفروع المتصلة قبل التنفيذ
### مثال: المعالجة ثم الإشعار
```
Trigger
│
├── Branch A: Update Customer Record
│
└── Branch B: Create Support Ticket
↘ ↙
Merged Step: Send Confirmation Email
```
يتم إرسال رسالة تأكيد البريد الإلكتروني فقط بعد أن يتم تحديث العميل وإنشاء التذاكر.
## أفضل الممارسات
* استخدم دائمًا **عُقد Filter** في بداية الفروع عندما تريد تنفيذًا شرطيًا
* اجعل شروط الفروع **متبادلة الإقصاء** لتجنّب الإجراءات المكررة
* اختبر سير العمل لديك ببيانات مختلفة للتأكد من تشغيل الفروع الصحيحة
* **أعد تسمية خطوات الفروع** بطريقة وصفية ليكون واضحًا ما يفعله كل مسار
* **ادمج الفروع** عندما تحتاج إلى إجراء نهائي بعد المعالجة المتوازية
## ذات صلة
* [الأسئلة الشائعة حول سير العمل](/l/ar/user-guide/workflows/how-tos/need-more-help/workflows-faq) — إجابات حول التنفيذ المتوازي
* [إجراءات سير العمل](/l/ar/user-guide/workflows/capabilities/workflow-actions) — الإجراءات المتاحة للفروع

View File

@@ -0,0 +1,183 @@
---
title: استخدم المكرّر
description: قم بالتكرار عبر مصفوفات السجلات لتنفيذ إجراءات على كل عنصر.
---
يتيح لك المكرّر التكرار عبر مصفوفة من السجلات وتنفيذ إجراءات على كلٍ منها. وهو ضروري لتدفّقات العمل التي تحتاج إلى معالجة سجلات متعددة أُرجعت بواسطة Search Records أو استُلِمت عبر ربط الويب.
## متى تستخدم المكرّر
| السيناريو | مثال |
| -------------------------------- | --------------------------------------------- |
| **معالجة نتائج البحث** | إرسال بريد إلكتروني إلى كل شخص تم العثور عليه |
| **التعامل مع مصفوفات ربط الويب** | إنشاء سجلات لكل عنصر بالتسلسل |
| **التحديثات الدفعيّة** | تحديث عدة سجلات بقيم محسوبة |
| **إشعارات** | تنبيه عدة أشخاص بخصوص حدثٍ ما |
## فهم المكرّر
يتوقع المكرّر إدخالاً عبارة عن **مصفوفة**. ثم يقوم بما يلي:
1. يأخذ أول عنصر من المصفوفة
2. تشغيل جميع الإجراءات داخل المربع مع هذا العنصر
3. ينتقل إلى العنصر التالي
4. يكرّر حتى تتم معالجة جميع العناصر
### اختيار المصفوفة المطلوب التكرار عليها
يمكن اختيار معظم مصادر المصفوفات (بحث السجلات، حقل مصفوفة لويب هوك، مشغّل يدوي دفعي) مباشرةً من منتقي المتغيّرات.
عندما تُرجِع خطوة **Code** أو **Logic Function** *مصفوفة من المستوى الأعلى*، يظهر ناتجها في منتقي المتغيّرات كعناصر مفهرسة (`0`، `1`، `2`، …). للتكرار على المصفوفة بالكامل، اختر خيار **Whole list** لتلك الخطوة — عندها يستنتج عنصر Iterator شكل كل عنصر من القائمة تلقائيًا.
## الإعداد الأساسي
### مثال: إرسال بريد إلكتروني للجميع ضمن نتائج البحث
**الهدف**: العثور على جميع جهات الاتصال في شركة محددة وإرسال بريد إلكتروني مخصص لكلٍ منهم.
### الخطوة 1: البحث عن سجلات
1. أضف إجراء **Search Records**
2. الكائن: **People**
3. عامل التصفية: Company يساوي "Acme Inc"
4. يُرجِع هذا مصفوفة من الأشخاص
### الخطوة 2: التحقق من وجود نتائج
1. أضف إجراء **Filter**
2. الشرط: `{{searchRecords.length}}` أكبر من 0
3. يمنع هذا أخطاء المكرّر عند كون النتائج فارغة
### الخطوة 3: إضافة Iterator
1. أضف إجراء **Iterator**
2. مدخل المصفوفة: اختر `{{searchRecords}}`
3. هذا ينشئ حلقة تكرار
### الخطوة 4: إضافة إجراءات داخل المكرّر
الإجراءات الموضوعة بعد Iterator تُشغَّل لكل عنصر:
1. إضافة إجراء **إرسال البريد الإلكتروني** (داخل الترتيب)
2. إلى: `{{iterator.currentItem.email}}`
3. الموضوع: مرحباً `{{iterator.currentItem.firstName}}`!
4. المتن: رسالة مخصّصة باستخدام حقول العنصر الحالي
### النتيجة
إذا أعاد Search Records 5 أشخاص، فسيقوم المكرّر بما يلي:
* يرسل بريداً إلكترونياً إلى الشخص 1
* يرسل بريداً إلكترونياً إلى الشخص 2
* ... يستمر لكل الأشخاص الخمسة
## الوصول إلى بيانات العنصر الحالي
داخل المكرّر، استخدم `{{iterator.currentItem}}` للوصول إلى السجل الحالي:
| المتغيّر | الوصف |
| --------------------------------------- | -------------------------------------- |
| `{{iterator.currentItem}}` | كائن السجل الحالي بالكامل |
| `{{iterator.currentItem.id}}` | معرّف السجل |
| `{{iterator.currentItem.email}}` | حقل البريد الإلكتروني |
| `{{iterator.currentItem.company.name}}` | اسم الشركة المرتبطة |
| `{{iterator.index}}` | الموضع الحالي في المصفوفة (بدءاً من 0) |
في منتقي المتغيّرات، يمكنك إما التعمّق في حقل معيّن من العنصر الحالي، أو اختيار **Use the whole item** للإشارة إلى العنصر الحالي بالكامل (`{{iterator.currentItem}}`). يكون اختيار العنصر بالكامل مفيدًا عندما تريد تمرير سجل كامل مباشرةً إلى خطوة لاحقة في خط التدفق بدلًا من إعادة بنائه حقلًا بحقل.
## أنماط شائعة
### تحديث عدة سجلات
**الهدف**: وضع علامة "متأخر" على جميع المهام المتأخرة عن موعدها
```
1. Search Records (Tasks, Due Date < Today, Status ≠ Completed)
2. Filter (length > 0)
3. Iterator (searchRecords)
└── Update Record
- Object: Tasks
- Record: {{iterator.currentItem.id}}
- Status: Late
```
### إنشاء سجلات من مصفوفة
**الهدف**: يتلقى الويبهوك طلباً يتضمن عدة عناصر، وإنشاء سجل لكل عنصر
```
1. Webhook Trigger (receives items array)
2. Filter (items.length > 0)
3. Iterator (trigger.body.items)
└── Create Record
- Object: Order Items
- Name: {{iterator.currentItem.name}}
- Quantity: {{iterator.currentItem.qty}}
- Related Order: {{trigger.body.orderId}}
```
### معالجة مشروطة داخل الحلقة
**الهدف**: إرسال بريد إلكتروني فقط لجهات الاتصال ذات العناوين الصالحة
```
1. Search Records (People)
2. Iterator (searchRecords)
└── Filter (currentItem.email is not empty)
└── Send Email
- To: {{iterator.currentItem.email}}
```
## استكشاف الأخطاء وإصلاحها
### "المكرّر يتوقع مصفوفة"
**السبب**: مرّرت سجلاً مفرداً بدلاً من مصفوفة.
**الإصلاح**: تأكّد من أنك تمرّر ناتج Search Records أو حقلاً من نوع مصفوفة، وليس سجلاً مفرداً.
```
✅ Correct: {{searchRecords}}
❌ Wrong: {{searchRecords[0]}}
```
### المكرّر لا يعمل
**السبب**: المصفوفة فارغة.
**الإصلاح**: أضف عامل تصفية قبل Iterator للتحقق من طول المصفوفة:
```
Filter: {{searchRecords.length}} > 0
```
### الإجراءات تُشغَّل مرات كثيرة جداً
**السبب**: أعاد Search Records سجلات أكثر مما هو متوقّع.
**الإصلاح**:
* أضف عوامل تصفية أكثر تحديداً إلى Search Records
* عيّن حداً في Search Records (بحد أقصى 200)
* أضف عامل تصفية داخل المكرّر لشروط إضافية
## اعتبارات الأداء
* **استخدام الأرصدة**: كل دورة تستهلك أرصدة لإجراءاتها
* **الوقت**: تستغرق المصفوفات الكبيرة وقتاً أطول للمعالجة
* **القيود**: فكّر في تنفيذ العمليات الكبيرة جداً على دفعات
* **قيود المعدّل**: قد تصل استدعاءات واجهات برمجة التطبيقات الخارجية إلى حدود المعدّل مع كثرة التكرارات
## أفضل الممارسات
1. **تحقق دائماً من طول المصفوفة** قبل Iterator لتجنّب الأخطاء
2. **أضف عوامل تصفية داخل الحلقات** عندما لا تحتاج جميع العناصر إلى معالجة
3. **أعد تسمية خطوة Iterator** لوصف ما تقوم بالتكرار عليه
4. **اختبر باستخدام مصفوفات صغيرة** قبل معالجة مجموعات بيانات كبيرة
5. **راقب تشغيلات سير العمل** لضمان اكتمال التكرارات كما هو متوقّع
## ذات صلة
* [إجراءات سير العمل](/l/ar/user-guide/workflows/capabilities/workflow-actions)
* [كيفية استخدام التفرعات](/l/ar/user-guide/workflows/capabilities/use-branches-in-workflows)
* [الأسئلة الشائعة حول سير العمل](/l/ar/user-guide/workflows/how-tos/need-more-help/workflows-faq)

View File

@@ -0,0 +1,332 @@
---
title: إجراءات سير العمل
description: تعرّف على الإجراءات المتاحة في عمليات سير العمل في Twenty.
---
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
## حول الإجراءات
تحدد الإجراءات ما يحدث بعد تنفيذ الزناد. يمكنك تسلسل عدة إجراءات معًا لبناء عمليات أتمتة معقدة.
<Tip>
* استخدم منتقي المتغيرات (انقر أيقونة `(x+)`) لاستعراض البيانات المتاحة من الخطوات السابقة
* مرّر المؤشر فوق أي حقل إدخال لمعرفة الخطوة التي يأتي منها المتغير — وهو أمر مفيد عندما يوجد الحقل نفسه (مثلًا، ID) في عدة خطوات سابقة
* امنح كل إجراء اسمًا وصفيًا لتسهيل الصيانة
</Tip>
## إجراءات السجل
<img src="/images/user-guide/workflows/workflow_actions.png" style={{width:'100%'}} />
### إنشاء سجل
يضيف سجل جديد إلى كائن محدد.
**الإعداد**:
* اختر الكائن المستهدف
* املأ الحقول الضرورية والاختيارية
* استخدم البيانات من الخطوات السابقة أو أدخِل القيم يدويًا لملء الحقول
**المخرجات**: بيانات السجل المنشأ حديثاً متاحة للاستخدام في الخطوات التالية.
### تحديث السجل
يقوم بتعديل سجل موجود في كائن محدد.
<img src="/images/user-guide/workflows/update_record.png" style={{width:'100%'}} />
**الإعداد**:
* اختر الكائن المستهدف
* اختر السجل المحدد لتحديثه.
* يمكنك إما اختيار سجل ثابت، باستخدام القائمة المنسدلة التي تعرض جميع السجلات المتاحة.
* أو يمكنك اختيار السجل ديناميكيًا بتحديد سجل تم العثور عليه في خطوة سابقة، باستخدام `(x+)`. لا يمكنك البحث عن السجل بناءً على معايير مختلفة في هذه المرحلة. إذا لم تكن قد حدّدت السجل بعد، فأضِف خطوة `Search Record` قبل خطوة `Update Record`.
* اختر الحقول لتعديل القيم وأدخل القيم الجديدة
**المخرجات**: بيانات السجل المحدثة متاحة للاستخدام في الخطوات التالية.
### حذف السجل
يزيل سجلاً من كائن محدد.
**التكوين**:
* اختر الكائن المستهدف
* اختر السجل المحدد لحذفه
**المخرجات**: تظل بيانات السجل المحذوف متاحة للاستخدام في الخطوات التالية.
### البحث في السجلات
يجد السجلات داخل كائن معين باستخدام شروط التصفية.
**التكوين**:
* اختر الكائن للبحث
* حدد معايير التصفية لتضييق النتائج
* قم بتكوين الفرز والقيود
**المخرجات**: تعيد السجلات المطابقة التي يمكن استخدامها في الخطوات اللاحقة.
<Note>
**الحد**: تعيد Search Records بحد أقصى **200 سجل**. إذا كنت بحاجة إلى معالجة المزيد، فأضِف عوامل تصفية محددة لتقليل النتائج أو استخدم عمليات سير عمل مجدولة للمعالجة على دفعات.
</Note>
**أفضل الممارسات**: استخدم [الفروع](/l/ar/user-guide/workflows/capabilities/workflow-branches) بعد Search Records للتعامل مع سيناريوهات "تم العثور" مقابل "لم يتم العثور".
### إدراج أو تحديث سجل
ينشئ سجلًا جديدًا أو يحدّث سجلًا موجودًا استنادًا إلى معايير المطابقة. يكون هذا مفيدًا عندما لا تكون متأكدًا مما إذا كان السجل موجودًا بالفعل.
<img src="/images/user-guide/workflows/upsert_double_identifier.png" style={{width:'100%'}} />
**التكوين**:
* اختر الكائن المستهدف
* لاحظ الحقول التي يمكن استخدامها للمطابقة: email لـ People، وdomain لـ Companies، وID لأي كائن، أو أي حقل مُعلَّم كـ Unique. ستحتاج إلى تعبئة واحد على الأقل من هذه الحقول أدناه.
* املأ قيم الحقول. لا تنسَ تعبئة معرّف فريد واحد على الأقل.
<Note>
**تعمل المطابقة عادةً بشكل أفضل عند إضافة معرّف فريد واحد فقط.** على سبيل المثال، ستطابق لقطة الشاشة أدناه الشركات استنادًا إلى domain الخاص بها. لا تكون قيمة ID مطلوبة بالضرورة.
</Note>
<img src="/images/user-guide/workflows/upsert_simple_identifier.png" style={{width:'100%'}} />
* استخدم البيانات من الخطوات السابقة لملء الحقول
**كيف يعمل**:
1. يبحث عن سجل يطابق معاييرك
2. إذا تم العثور عليه → يحدّث السجل الموجود
3. إذا لم يُعثر عليه → ينشئ سجلًا جديدًا
**المخرجات**: بيانات السجل التي تم إنشاؤها أو تحديثها متاحة للاستخدام في الخطوات التالية.
## إجراءات التدفق
### مكرر
**يتكرر عبر مصفوفة من السجلات** المُعادة من خطوة سابقة، مما يتيح لك تنفيذ إجراءات على كل سجل بشكل فردي.
**التكوين**:
* حدد مجموعة من السجلات من خطوة سابقة (على سبيل المثال، النتائج من سجلات البحث، من المشغل اليدوي مع توفر الكبريت، من عقدة البرمجة). عندما تُرجِع خطوة Code أو دالة منطقية مصفوفة من المستوى الأعلى، حدِّد خيار **Whole list** للتكرار عبر الإخراج بالكامل.
* حدد الإجراءات لتنفيذها على كل سجل في الحلقة.
<Note>
- يمكنك إضافة عدة إجراءات داخل ترتير.
- عند استخدام الفروع داخل ترتير، تأكد من أن الخطوة الأخيرة من كل فرع تتصل بعودة إلى ترتور لإغلاق الحلقة التكرارية.
</Note>
* الوصول إلى حقول `Current Item`: لاستخدام حقول السجل الجاري معالجته، انقر على خطوة **المُكرِّر**، ثم اختر **العنصر الحالي**. ستُعرَض قائمة الحقول المتاحة من ذلك السجل ويمكن اختيارها لاستخدامها في الإجراءات اللاحقة. يمكنك أيضًا تحديد **Use the whole item** لتمرير العنصر الحالي بالكامل إلى خطوة لاحقة.
<VimeoEmbed videoId="1146577247" title="عرض توضيحي بالفيديو" />
### تصفية
يقوم بتصفية السجلات بناءً على الشروط المحددة، مما يسمح فقط للسجلات التي تلبي المعايير بالمرور.
**التكوين**:
* اختر السجل لتصفيته
* حدد شروط ومعايير التصفية
* قم بتكوين السجلات التي يجب أن تمر إلى الخطوات اللاحقة
<Note>
1. **المخرجات**: عُقد التصفية لا تُرجِع بيانات — فهي تعمل كبوابات. إذا تم استيفاء الشروط، يتابع سير العمل. وإلا سيتوقف سير العمل عند ذلك الفرع.
2. يمكن استخدام العامل `IS` مع الحقول الرقمية. يعمل كأنه `EQUAL`.
</Note>
### التأخير
يُوقف تنفيذ سير العمل لمدة محددة أو حتى تاريخ/وقت معين.
**أنواع التأخير**:
| النوع | الوصف |
| ---------------- | ----------------------------------------------------- |
| **المدة** | الانتظار لمدة زمنية محددة (أيام، ساعات، دقائق، ثوانٍ) |
| **تاريخ مُجدول** | الانتظار حتى تاريخ ووقت محددين |
**إعدادات المدة**:
* تعيين الأيام والساعات والدقائق و/أو الثواني
* دمج وحدات متعددة (مثل يومين و4 ساعات)
**إعدادات التاريخ المُجدول**:
* اختر تاريخًا ووقتًا
* يمكن الإشارة إلى حقل تاريخ من خطوة سابقة (مثل المتابعة بعد 3 أيام من اجتماع)
**حالات الاستخدام**:
* انتظر 24 ساعة قبل إرسال بريد متابعة إلكتروني
* إيقاف مؤقت حتى تاريخ إغلاق الفرصة
* جدولة الإجراءات ضمن ساعات العمل
<Note>
لا يمكن أن يكون التاريخ المُجدول في الماضي. إذا استُخدم حقل تاريخ من خطوة سابقة وكان التاريخ قد مضى بالفعل، فسيفشل سير العمل.
</Note>
**الحدود والرصيد**:
* **لا يوجد حد أقصى للمدة** — يمكنك تعيين تأخيرات بالدقائق أو الأيام أو الأسابيع أو أكثر
* **يُستهلَك رصيد واحد** عند تنفيذ عقدة التأخير، بغض النظر عن المدة
* **لا يُستهلك أي رصيد** أثناء الانتظار — تأخير 5 دقائق يكلف مثل تأخير 5 أيام
## إجراءات الاتصال
### إرسال البريد الإلكتروني
يرسل بريدًا إلكترونيًا من سير العمل الخاص بك. هذا رائع لرسائل البريد الجماعية المعتمدة على قوالب. ستبدو رسائل البريد الإلكتروني مثل تلك التي ترسلها من صندوق بريدك.
وهو غير مناسب للنشرات الإخبارية (التي تتطلب تنسيقا أغنى) أو تسلسل البريد الإلكتروني الآلي.
**المتطلبات الأساسية**: أضف حساب بريد إلكتروني في الإعدادات → الحسابات
**التكوين**:
* اختر حساب البريد الإلكتروني المُرسل
<Note>
يمكنك إرسال رسائل البريد الإلكتروني فقط من صناديق بريد متزامنة مع حساب Twenty الخاص بك. إرسال الرسائل من صناديق بريد أعضاء الفريق الآخرين (مثل بريد مالك الحساب) ضمن الخطة المستقبلية.
</Note>
في جميع الخطوات التالية، يمكنك الرجوع إلى متغيرات من الخطوات السابقة لأغراض التخصيص.
* ادخل عنوان البريد الإلكتروني المستلم.
<Note>
حاليًا يمكن اختيار مستلم واحد فقط.
</Note>
* اضبط سطر الموضوع.
* قم بإنشاء نص الرسالة. يمكنك تنسيق الروابط، وإنشاء قوائم رقمية، وقوائم نقاط الرصاص، وإضافة مرفقات.
<Note>
إضافة توقيعات HTML غير ممكنة في الوقت الحالي.
</Note>
### نموذج
يعرض نموذجاً أثناء تنفيذ سير العمل لجمع مدخلات المستخدم. يمكن بعد ذلك استخدام الردود في الخطوات اللاحقة لإنشاء سجلات أو إرسال رسائل بريد إلكتروني أو تنفيذ أي إجراء آخر بناءً على المُدخل.
<Warning>
**تم تصميم النماذج للمشغلات اليدوية فقط**. بالنسبة لمهام سير العمل مع محركات أخرى (سجل تم إنشاؤه، تم تحديثه، إلخ)، يمكن الوصول إلى النماذج فقط من خلال واجهة تشغيل سير العمل، وهو ليس التجربة المتوقعة. وسيصدر مركز للإخطار في عام 2026 لتقديم الدعم المناسب لاستمارات تدفق العمل الآلي.
</Warning>
**التكوين**:
* قم بتهيئة الحقول التي سيُطلب من المستخدمين تعبئتها. لكل حقل، اختر
* نوعًا من بين: نص، رقم، تاريخ، سجل مُعطى، حقل اختيار. الحقول من جميع الكائنات متاحة للاختيار.
* تسمية
* قيمة افتراضية ضمن `Placeholder` (اختياري)
* حرّر عنوان النموذج
**المخرجات**: استجابات النموذج متاحة للاستخدام في الخطوات اللاحقة.
**مثال**: سير العمل "الرصاص السريع" متاح بشكل افتراضي في جميع مساحات العمل، متاح في أي مكان في قائمة الأوامر 'Cmd+K\`.
**كيفية تعبئة النموذج**:
* تفعيل سير العمل اليدوي الخاص بك من قائمة الأوامر `Cmd+K`
* املأ النموذج المعروض في اللوحة الجانبية ثم انقر `Submit`.
<Note>
لا يمكن جعل الحقول إلزامية.
</Note>
<VimeoEmbed videoId="1147277989" title="عرض توضيحي بالفيديو" />
## إجراءات التكامل
### كود
يشغل جافا سكريبت مخصص ضمن سير العمل الخاص بك.
في الخلفية، يستند كل إجراء Code إلى **دالة منطقية** خاصة به — وهي دالة TypeScript على جانب الخادم تعمل على منصة Twenty. عندما تضيف إجراء Code، يقوم Twenty بإنشاء دالة منطقية مخصَّصة لتلك الخطوة ويُظهِر محرِّرها مضمَّنًا، بحيث يكون الكود الذي تكتبه جزءًا من سير العمل.
**التكوين**:
* الوصول إلى المتغيرات من الخطوات السابقة. يمكنك تعديل أسماء المتغيرات بشكل ديناميكي.
<VimeoEmbed videoId="1147281795" title="عرض توضيحي بالفيديو" />
* اكتب شيفرة جافا سكريبت في المحرر
* إرجاع المتغيرات للاستخدام في الخطوات اللاحقة
* اختبر الكود مباشرة في الخطوة
<Note>
إذا كنت بحاجة إلى استخدام مفاتيح API خارجية في كودك، فيجب إدخالها مباشرةً في جسم الدالة. لا يمكنك تكوين مفاتيح API في مكان آخر والإشارة إليها في الدالة المنطقية.
</Note>
<Tip>
**هل تعمل مع المصفوفات؟** قد تأتي المصفوفات من أنظمة خارجية أو من خطوات سابقة على هيئة سلاسل نصية. راجع [كيفية التعامل مع المصفوفات في إجراءات Code](/l/ar/user-guide/workflows/how-tos/advanced-configurations/handle-arrays-in-code-actions) للحل.
</Tip>
<Tip>
انقر على أيقونة المربع في أعلى يمين محرر الكود لعرضه بملء الشاشة — فهذا مفيد لأن عرض المحرر الافتراضي محدود.
</Tip>
#### إعادة استخدام دالة منطقية عبر سير عمل متعددة
إجراء Code المضمَّن ممتاز للمنطق لمرة واحدة، لكن الكود الذي يحتويه يخص تلك الخطوة الواحدة فقط. عندما تريد مشاركة المنطق نفسه عبر عدة سير عمل — أو الاحتفاظ به كمصدر مُدار بالإصدارات ضمن تطبيق — عرِّف **دالة منطقية قابلة لإعادة الاستخدام** بدلًا من نسخ ولصق الكود في كل إجراء Code.
يتم تعريف دالة منطقية مرة واحدة في تطبيق (باستخدام `defineLogicFunction` في حزمة SDK) وتُتاح في مُنشئ سير العمل عن طريق إضافة `workflowActionTriggerSettings`. بمجرد تثبيت تطبيقك، تظهر تلك الدالة كإجراء مستقل في مُنشئ سير العمل، جنبًا إلى جنب مع الإجراءات المضمَّنة. يؤدي اختيارها إلى عرض حقول الإدخال التي صرَّحتَ عنها (مع منتقي المتغيّرات، تمامًا مثل الإجراءات الأخرى) وتشغيل الكود المشترك — دون الحاجة إلى JavaScript مضمَّن.
| | إجراء Code | دالة منطقية قابلة لإعادة الاستخدام |
| ------------------- | --------------------------------------------- | ----------------------------------------------------------------------- |
| **مكان وجود الكود** | محرِّر مضمَّن، مرتبط بخطوة واحدة في سير العمل | يُعرَّف في تطبيق، مع إدارة الإصدارات في نظام التحكم في الشيفرة المصدرية |
| **إعادة الاستخدام** | يتم نسخه ولصقه لكل خطوة | يُضاف كإجراء في أي سير عمل |
| **المدخلات** | متغيّرات موصولة في المحرِّر | حقول تُعرَض من مخطط الإدخال الذي صرَّحتَ عنه |
| **الأفضل لـ** | منطق سريع خاص بسير عمل معيّن | منطق مشترك يُستخدَم عبر عدة سير عمل |
كلاهما يعمل على بيئة تشغيل الدالة المنطقية نفسها، لذا يمكن ترقية إجراء Code الذي جرَّبته مضمَّنًا لاحقًا إلى دالة منطقية قابلة لإعادة الاستخدام مع تغييرات طفيفة.
<Tip>
للاطّلاع على مرجع موجَّه للمطوّرين حول تعريف الدوال المنطقية وإتاحتها في مُنشئ سير العمل، راجع صفحة [Logic Functions](/l/ar/developers/extend/apps/logic/logic-functions) — وخصوصًا قسم **Exposing a function as an AI tool or workflow action** و `workflowActionTriggerSettings`.
</Tip>
### طلب HTTP
يرسل طلبًا إلى واجهة برمجية خارجية كجزء من سير العمل الخاص بك.
<img src="/images/user-guide/workflows/http_action.png" style={{width:'100%'}} />
**التكوين**:
* ادخل عنوان رابط واجهة برمجية. يمكن استخدام معاملات من خطوات سابقة.
* اختر طريقة HTTP (GET, POST, PUT, PATCH, DELETE)
* أضف الرؤوس والقيم المطلوبة
* قدّم مثالًا للمخرجات لمعاينة البنية
## إجراءات الذكاء الاصطناعي
### وكيل ذكاء اصطناعي - قريبًا
يشغّل وكيل ذكاء اصطناعي داخل سير العمل لديك لتنفيذ مهام ذكية.
**التكوين**:
* **الوكيل**: اختر وكيلاً للذكاء الاصطناعي موجودًا أو استخدم الوكيل الافتراضي
* **المطالبة**: اكتب التعليمات لوكيل الذكاء الاصطناعي
* ارجع إلى متغيرات من خطوات سابقة داخل المطالبة
**ما الذي يمكن لوكلاء الذكاء الاصطناعي فعله**:
* تحليل البيانات وتلخيصها
* تصنيف السجلات أو توزيعها ضمن فئات
* إنشاء محتوى نصي
* اتخاذ قرارات بناءً على البيانات
* التفاعل مع بيانات نظام إدارة علاقات العملاء لديك باستخدام الأدوات
**المخرجات**: رد وكيل الذكاء الاصطناعي متاح للاستخدام في الخطوات التالية. إذا كان للوكيل مخطط مخرجات مُهيكل، فسيتبع الرد ذلك التنسيق.
<Note>
تستهلك إجراءات وكيل الذكاء الاصطناعي أرصدة سير العمل بناءً على نموذج الذكاء الاصطناعي المستخدم. راجع [أرصدة سير العمل](/l/ar/user-guide/workflows/capabilities/workflow-credits) للحصول على التفاصيل.
</Note>
<Note>
يحترم وكلاء الذكاء الاصطناعي الأذونات المستندة إلى الأدوار. يمكنك تعيين أدوار محددة للوكلاء ضمن **الإعدادات → الأعضاء → الأدوار** للتحكم في البيانات التي يمكنهم الوصول إليها. راجع [الأذونات](/l/ar/user-guide/permissions-access/capabilities/permissions) للحصول على التفاصيل.
</Note>

View File

@@ -0,0 +1,66 @@
---
title: تفرعات سير العمل
description: أنشئ مسارات متوازية ومنطقًا شرطيًا في سير العمل لديك.
---
تتيح لك التفرعات تقسيم سير العمل إلى مسارات متعددة يمكن أن تعمل بالتوازي أو بشكل شرطي استنادًا إلى بياناتك.
<img src="/images/user-guide/workflows/branches.png" style={{width:'100%'}} />
## كيفية عمل التفرعات
عند إنشاء عدة اتصالات من عقدة واحدة، يصبح كل مسار تفرعًا. افتراضيًا، **تُنفَّذ جميع التفرعات بالتوازي**—ولا تنتظر بعضها بعضًا.
## إنشاء التفرعات
### إضافة تفرع جديد
1. **انقر بزر الماوس الأيمن على اللوحة الرئيسية** لسير العمل (وليس على عقدة موجودة)
2. انقر على **إضافة عقدة**
3. اختر نوع العقدة لتفرعك الجديد
4. اسحب سهمًا من أسفل الخطوة السابقة إلى أعلى هذا الإجراء الجديد
5. كرّر لإضافة مزيد من التفرعات من العقدة نفسها
<Note>
كل تفرع مستقل. إن إضافة تفرع لا يؤثر في المسارات الأخرى الموجودة من تلك العقدة.
</Note>
### التخطيط المرئي
تظهر التفرعات كمسارات متوازية في محرر سير العمل. يمكنك سحب العقد لإعادة ترتيب التخطيط المرئي دون التأثير في التنفيذ.
## التفرعات الشرطية
نظرًا إلى أن جميع التفرعات تعمل افتراضيًا، استخدم عقد **عامل التصفية** للتحكم في المسارات التي تُنفَّذ فعليًا:
| التفرع | شرط عامل التصفية | الإجراء |
| ------ | ----------------------- | --------------------------- |
| A | المرحلة = "Won" | إرسال بريد إلكتروني للتهنئة |
| B | المرحلة = "Lost" | إنشاء مهمة متابعة |
| C | المرحلة = "Negotiation" | إخطار المدير |
1. أنشئ تفرعات من المشغّل لديك أو الإجراء
2. أضف عقدة **عامل التصفية** بوصفها الخطوة الأولى في كل تفرع
3. قم بإعداد كل عامل تصفية بشروط متبادلة الاستبعاد
4. أضف إجراءاتك بعد كل عامل تصفية
سيتابع التنفيذ فقط التفرع/التفرعات التي يتحقق فيها شرط عامل التصفية.
## دمج التفرعات
**لا تُدمَج التفرعات تلقائيًا.** يعمل كل تفرع بشكل مستقل حتى ينتهي. لديك مرونة كاملة في كيفية التعامل مع ذلك:
* **الخيار 1: إبقاء التفرعات منفصلة**
يتولى كل تفرع إجراءات المتابعة الخاصة به بشكل مستقل. هذه أبسط مقاربة عندما لا تحتاج التفرعات إلى الالتقاء.
* **الخيار 2: دمج التفرعات يدويًا**
عند إنشاء سير العمل، يمكنك توصيل عدة تفرعات يدويًا بالإجراء اللاحق نفسه. ما عليك سوى سحب الأسهم من نهاية كل تفرع إلى عقدة مشتركة.
<Note>
بينما يمكنك استخدام عقدة [Delay](/l/ar/user-guide/workflows/capabilities/workflow-actions#delay) لإيقاف التنفيذ مؤقتًا، إلا أنه لا يمكن ضبطها حاليًا للانتظار "حتى ينتهي تفرع آخر".
</Note>
## ذات صلة
* [كيفية استخدام التفرعات في سير العمل](/l/ar/user-guide/workflows/capabilities/use-branches-in-workflows) - دليل خطوة بخطوة
* [إجراءات سير العمل](/l/ar/user-guide/workflows/capabilities/workflow-actions) - الإجراءات المتاحة بما في ذلك عامل التصفية

View File

@@ -0,0 +1,75 @@
---
title: رصيد سير العمل
description: فهم استهلاك أرصدة سير العمل وإدارتها.
---
أرصدة سير العمل تدعم عمليات الأتمتة لديك في Twenty. فهم كيفية عملها يساعدك على تحسين التكاليف وإدارة ميزانية الأتمتة بفعالية.
## تخصيص الأرصدة
تخصص أرصدة سير العمل بناء على دورة الفوترة لديك، وليس على مستوى خطتك:
| دورة الفوترة | الأرصدة |
| --------------- | ---------------- |
| **اشتراك شهري** | 5 أرصدة في الشهر |
| **اشتراك سنوي** | 50 رصيد في السنة |
<Note>
تعد 5 أرصدة في الشهر سخية لعمليات الأتمتة القياسية. لن تتجاوز معظم الفرق هذا الحد مع استخدام سير العمل النموذجي. تكون الحاجة إلى أرصدة إضافية أساسًا لإجراءات Code المتقدمة ولعمليات سير العمل المدعومة بالذكاء الاصطناعي.
</Note>
## كيف يعمل استهلاك الرصيد
يتم استهلاك الأرصدة عند تنفيذ عمليات سير العمل، وليس عند إنشائها. يستهلك كل إجراء سير عمل الرصيد بناءً على تعقيده.
### استهلاك الرصيد حسب نوع الإجراء
* **العمليات الأساسية الداخلية**: استهلاك رصيد منخفض جدًا
* البحث في السجلات
* إنشاء سجل
* تحديث السجل
* حذف السجل
* إجراءات النماذج
* **عمليات معقدة**: استهلاك أعلى للأرصدة
* إجراءات الكود (تنفيذ JavaScript)
* طلبات HTTP إلى الخدمات الخارجية
* **ميزات الذكاء الاصطناعي**: استهلاك أعلى للأرصدة
* تستهلك إجراءات وكيل الذكاء الاصطناعي الأرصدة بناء على نموذج الذكاء الاصطناعي المستخدم
* تستخدم المطالبات الأكثر تعقيدا والمخرجات الأطول أرصدة أكثر
* **إجراءات التأخير**: استهلاك ضئيل للأرصدة
* تستهلك عقدة Delay **رصيد واحد** عند التنفيذ
* **لا تستهلك أي أرصدة** خلال فترة الانتظار
* التأخير لمدة 5 دقائق يكلف المقدار نفسه مثل التأخير لمدة 5 أيام
### الخصم في الوقت الحقيقي
يتم خصم الرصيد في الوقت الفعلي عند تنفيذ سير العمل. هذا يعني:
* لا تستهلك مسودات سير العمل أرصدة.
* لا تستخدم مخصص الأرصدة لديك إلا عمليات سير العمل النشطة والجارية.
* تظل عمليات سير العمل الفاشلة تستهلك أرصدة مقابل الخطوات المكتملة.
## إدارة الرصيد
### التحقق من استخدام الرصيد
1. اذهب إلى **الإعدادات → الفواتير**
2. اعرض استهلاكك الحالي من الأرصدة والرصيد المتبقي
3. راقب أنماط الاستخدام لتحسين عمليات سير العمل لديك
### شراء رصيد إضافي
إذا كنت بحاجة إلى المزيد من الأرصدة بما يتجاوز مخصص خطتك:
1. اذهب إلى **الإعدادات → الفواتير**
2. اضغط على الخيار لشراء رصيد إضافي. توفر باقات بأحجام مختلفة.
3. يتم إضافة الرصيد إلى الرصيد الحالي الخاص بك.
## أفضل الممارسات
* **تجهيز الدفعات**: استخدم العمليات الضخمة وإجراءات الترميز بكفاءة لتقليل المكالمات الفردية
* **تحسين المشغلات اليدوية**: بالنسبة للمشغلات اليدوية، اختر خيار التوفر `Bulk` لمعالجة سجلات متعددة في تشغيل واحد لسير عمل
* تحسين إجراءات الكود للكفاءة

View File

@@ -0,0 +1,93 @@
---
title: عمليات تشغيل سير العمل
description: راقِب وأدِر عمليات تنفيذ سير العمل.
---
## حول عمليات التشغيل
**تشغيل** هو سجل لتنفيذ سير العمل. في كل مرة يتم فيها تشغيل سير عمل—سواءً بواسطة حدث سجل، أو جدول زمني، أو إجراء يدوي، أو خطاف ويب—يتم إنشاء عملية تشغيل جديدة.
## عرض عمليات التشغيل
### من محرر سير العمل
1. افتح سير العمل الذي تريد مراقبته
2. انقر على لوحة **التشغيل** في الجانب الأيمن
3. اطلع على قائمة بأحدث عمليات التشغيل مع حالتها
### من عرض عمليات تشغيل سير العمل
1. انتقل إلى **عمليات تشغيل سير العمل** في الشريط الجانبي
2. اعرض عمليات التشغيل عبر جميع سير العمل
3. رشّح حسب الحالة أو سير العمل أو التاريخ
## حالات التشغيل
| الحالة | الوصف |
| ---------------- | ----------------------------------------------------------------- |
| **جارٍ التنفيذ** | سير العمل قيد التنفيذ حاليًا |
| **مكتمل** | انتهى سير العمل بنجاح |
| **فشل** | واجه سير العمل خطأً وتوقّف |
| **في انتظار** | سير العمل متوقف مؤقتًا (مثال: ينتظر إجراء التأخير أو إرسال نموذج) |
## تفاصيل عملية التشغيل
انقر على أي عملية تشغيل للاطلاع على:
* **الحالة**: الوضع الحالي لعملية التشغيل
* **وقت البدء**: وقت بدء عملية التشغيل
* **المدة**: الوقت الذي استغرقته عملية التشغيل
* **بيانات المُشغِّل**: المُدخل الذي بدأ سير العمل
* **مخرجات الخطوة**: البيانات التي ترجعها كل خطوة
* **رسائل الخطأ**: إذا فشلت عملية التشغيل، ما الخطأ الذي حدث
## تنفيذ خطوة بخطوة
تعرض كل عملية تشغيل التقدم خلال سير عملك:
1. اطلع على الخطوات التي اكتملت بنجاح
2. حدّد مواضع حدوث الفشل
3. اعرض البيانات الممررة بين الخطوات
4. استكشف المشكلات وأصلحها بفحص مدخلات الخطوات ومخرجاتها
## التعامل مع الأخطاء
عند فشل عملية تشغيل:
1. افتح عملية التشغيل الفاشلة
2. حدّد الخطوة التي تسببت في الفشل
3. تحقق من رسالة الخطأ للتفاصيل
المشكلات الشائعة:
* الحقول المطلوبة المفقودة
* تنسيق بيانات غير صالح
* أخطاء واجهة برمجة التطبيقات الخارجية
* مشكلات الصلاحيات
## إعادة تشغيل سير العمل
إذا فشلت عملية تشغيل، يمكنك:
* إصلاح المشكلة الأساسية وانتظار المحفّز التالي
* بالنسبة لسير العمل اليدوي، أعد تشغيله باستخدام البيانات نفسها أو بيانات محدّثة
* راجع منطق سير العمل لمنع الإخفاقات المستقبلية
## نصائح الأداء
### إدارة سجل التشغيل
* يتم الاحتفاظ بالأنابيب للمراجع التاريخية
* قد يتم أرشفة التطبيقات القديمة جداً تلقائيًا
* تصدير بيانات التشغيل إذا كنت بحاجة إلى الاحتفاظ بسجلات
### رصد أفضل الممارسات
* التحقق من التشغيل بانتظام بعد تفعيل سير العمل الجديد
* مراجعة عمليات التشغيل الفاشلة لتحديد الأنماط
## ذات صلة
* [محفّزات سير العمل](/l/ar/user-guide/workflows/capabilities/workflow-triggers)
* [إجراءات سير العمل](/l/ar/user-guide/workflows/capabilities/workflow-actions)
* [استكشاف الأخطاء في سير العمل](/l/ar/user-guide/workflows/how-tos/need-more-help/workflow-troubleshooting)

View File

@@ -0,0 +1,137 @@
---
title: محفزات سير العمل
description: تعرّف على المحفزات المختلفة التي تُشغِّل سير العمل لديك.
---
## حول المحفزات
تبدأ سير العمل دائمًا بمحفز واحد يحدد متى ينبغي تشغيل الأتمتة.
<img src="/images/user-guide/workflows/workflow_triggers.png" style={{width:'100%'}} />
<Tip>
**الكائنات المتقدمة مدعومة!** إلى جانب كائنات CRM القياسية (الأشخاص، الشركات، الفرص)، يمكنك أيضًا تشغيل سير العمل وتنفيذ إجراءات على:
* أعضاء مساحة العمل
* أحداث التقويم
* الرسائل (رسائل البريد الإلكتروني)
* المهام، والملاحظات، والعديد من كائنات النظام الأخرى
يفتح هذا المجال لأتمتة قوية مثل إشعار أعضاء الفريق عند إنشاء أحداث التقويم، أو معالجة رسائل البريد الإلكتروني الواردة تلقائيًا.
</Tip>
## إنشاء سجل
يبدأ سير العمل عندما يتم إنشاء سجل جديد في كائن محدد (أشخاص أو شركات أو فرص أو أي كائن مخصص).
**التكوين**: حدد نوع الكائن لمراقبة السجلات الجديدة.
<Note>
* هذا المشغل رائع للسجلات التي تم إنشاؤها بواسطة CSV، علبة البريد ومزامنة التقويم، أو API.
* **لا يُنصح به للسجلات التي تُنشأ يدويًا**: مع هذا المحفز، تبدأ عمليات سير العمل فور إنشاء السجل. نظرًا لأن واجهة المستخدم العشرين توفر الحفظ التلقائي على متن الطائرة (لا يوجد وضع تحرير ثم التحقق لحفظ السجلات)، سيتم تشغيل سير العمل قبل أن يقوم المستخدم بإدخال جميع الحقول.
لتشغيل سير العمل هذا على السجلات التي تم إنشاؤها يدويًا، يُوصى باستخدام المحفز `Record is created or updated` بدلًا من ذلك.
</Note>
## تحديث السجل
يبدأ سير العمل عندما يتم إجراء تغييرات على سجل موجود.
**التكوين**:
* اختر نوع الكائن
* اختر الحقول التي تريد مراقبتها للتغييرات بشكل اختياري
## تحديث أو إنشاء سجل
يبدأ سير العمل عندما يتم إنشاء أو تحديث سجل في كائن محدد.
**أهمية الموضوع**: هذا المحفز مهم بشكل خاص لأن السجلات التي تنشأ بطرق مختلفة تتصرف بشكل مختلف:
* **استيراد API/CSV**: يتم إنشاء السجلات مع ملء جميع الحقول فورًا
* **الإنشاء اليدوي**: يتم إنشاء السجلات أولاً، ثم يتم إضافة الحقول في التحديثات اللاحقة
**التكوين**:
* اختر نوع الكائن لمراقبته
* اختر الحقول التي تريد مراقبتها للتغييرات بشكل اختياري
* سيتم تشغيل سير العمل في كل من الإنشاء الأولي وأي تحديثات لاحقة
## حذف السجل
يبدأ سير العمل عندما يتم إزالة سجل من كائن.
**التكوين**: حدد نوع الكائن لمراقبة عمليات الحذف.
## المحفز اليدوي
يبدأ سير العمل عندما يتم تشغيله بواسطة إجراء المستخدم. يمكن الوصول إلى هذا المحفز من خلال قائمة `Cmd+K` أو عبر زر مخصص سيُعرض في شريط التنقل العلوي بعد تحديد سجل/سجلات.
<img src="/images/user-guide/workflows/add_to_newsletter_button.png" style={{width:'100%'}} />
**إعداد التوفر**:
اختر كيفية التعامل مع تحديد السجل في سير العمل:
* **العالمي**: لا يتطلب أي سجل لتشغيل سير العمل هذا. يتم تشغيل سير العمل من قائمة الأوامر 'Cmd+K' في أي مكان (من أي كائن)، ولا يستخدم السجل (السجلات) كمدخل.
لتوفر **واحد** و **السائب** ، سيتم تمرير السجلات المحددة إلى سير العمل الخاص بك. تم تكوين هذا لكائن معين، ويمكن تحديد عدة سجلات قبل تشغيل سير العمل.
* **واحد**: سير العمل سيتم تشغيله من البداية إلى النهاية أكبر عدد من المرات التي يتم فيها اختيار السجلات.
<Note>
**حد مرن: 100 عملية تشغيل/دقيقة**. بعد ذلك، تظل عمليات سير العمل في حالة "Not Started" ويتم معالجتها تدريجيًا—إما بواسطة مهمة خلفية أو عندما يدخل سير عمل آخر قائمة الانتظار. هذا يعني أنه يمكنك تحديد أكثر من 100 سجل باستخدام محفز واحد؛ ستكون عملية التنفيذ أبطأ فقط.
</Note>
* **سباب**: سير العمل سيتم تشغيله مرة واحدة، مع توفير قائمة السجلات بأكملها كمدخل. هذا يعني أن سير العمل يحتاج إلى احتواء [إجراء المُكرِّر](/l/ar/user-guide/workflows/capabilities/workflow-actions#iterator).
<Note>
هذا أكثر تقدمًا، وهو الأفضل لمن يرغبون في تحسين عدد مرات تشغيل سير العمل.
</Note>
<img src="/images/user-guide/workflows/manual_trigger.png" style={{width:'100%'}} />
**تكوين إضافي**:
* حدد الكائن المستهدف (للتوفر الفردي والشامل)
* اختر رمز الأمر لتفعيل سير العمل
* قم بتكوين موضع شريط التنقل (مثبت أو غير مثبت)
**طرق الوصول**:
* قائمة `Cmd+K` للعثور على وتشغيل عمليات سير العمل اليدوية
* زر مخصص في شريط التنقل العلوي (إذا تم تكوينه)
## محفز قائم على الوقت: وفق جدول زمني
يبدأ سير العمل على أساس دوري تحدده.
**التكوين**:
* اختر وحدة الوقت (الدقائق، الساعات، الأيام)
* أدخل قيمة أو استخدم تعبيرات كرون مخصصة للجدولة المتقدمة
<Note>
**المنطقة الزمنية**: تعمل عمليات سير العمل المجدولة وفق **UTC**. عند تعيين الساعات للجداول اليومية، حوّل وقتك المحلي إلى UTC.
</Note>
## محفز خارجي: ويب هوك
يبدأ سير العمل عندما يتم استقبال طلب GET أو POST من خدمة خارجية.
<img src="/images/user-guide/workflows/webhook_trigger.png" style={{width:'100%'}} />
**التكوين**:
* يوفر سير العمل عنوان URL فريدًا لويب هوك—انسخه وأضفه إلى نظامك الخارجي كنقطة نهاية للاستدعاء.
* بالنسبة لطلبات POST، حدِّد البنية المتوقعة لمحتوى الطلب حتى يعرف Twenty ما البيانات المتوقع تلقيها. أضف هنا الحقول التي ستستلمها والتي ستكون مطلوبة أدناه في سير العمل لديك.
* قم بتكوين المصادقة (قريبًا).
## اختيار المحفز المناسب
| حالة الاستخدام | المحفز الموصى به |
| ------------------------------------------ | ------------------------ |
| العملاء المحتملون الجدد يحتاجون إلى معالجة | إنشاء سجل |
| تغييرات البيانات تحتاج إلى مزامنة | تحديث السجل |
| استيراد/معالجة البيانات يدويًا | تحديث أو إنشاء سجل |
| التنظيف بعد الحذف | حذف السجل |
| إجراء يبدأه المستخدم | التشغيل يدويًا |
| تقارير متكررة | بجدول زمني |
| تكامل خارجي | ويب هوك أو وفق جدول زمني |

View File

@@ -0,0 +1,84 @@
---
title: إصدارات سير العمل
description: إدارة إصدارات ومسودات سير العمل.
---
## حول الإصدارات
في كل مرة تقوم فيها بتنشيط سير عمل، يتم إنشاء إصدار جديد. يتيح لك ذلك تتبُّع التغييرات بمرور الوقت والرجوع إلى التكوينات السابقة عند الحاجة.
## حالات الإصدارات
| الحالة | الوصف |
| --------- | ----------------------------------- |
| **مسودة** | قيد التحرير، ولم تُنشَر بعد |
| **نشط** | إصدار فعّال يستجيب للمحفِّزات |
| **معطل** | كان نشطًا مسبقًا ولكن أُوقِف يدويًا |
| **مؤرشف** | إصدارات سابقة محفوظة للسجلّ |
## العمل مع المسودات
عند تحرير سير عمل نشط، تُحفَظ تغييراتك كـ **مسودة**. يستمر الإصدار النشط في العمل أثناء عملك على التحديثات.
بعد الانتهاء من التحرير، يمكنك:
* **تنشيط**: نشر المسودة كالإصدار النشط الجديد (يُؤرشف الإصدار السابق)
* **تجاهل**: حذف المسودة والاحتفاظ بالإصدار النشط الحالي
## سجل الإصدارات
### عرض الإصدارات السابقة
1. افتح سير العمل
2. انقر فوق علامة التبويب **الإصدارات**
3. اعرض جميع الإصدارات السابقة مع الطوابع الزمنية
### استعادة إصدار
1. اعثر على الإصدار الذي تريد استعادته
2. انقر **استخدام كمسودة**
3. يُنسَخ الإصدار إلى مسودة جديدة
4. أجرِ أي تحديثات لازمة
5. قم بالتنشيط عند الاستعداد
## أفضل الممارسات
### إدارة الإصدارات
* قم بالتنشيط فقط عند الجاهزية للبيئة الإنتاجية
* حافظ على التغييرات ذات المغزى بين الإصدارات
* وثّق التغييرات الكبرى في أسماء أو أوصاف سير العمل
* اختبر في وضع المسودة قبل التنشيط
### التراجع عن التغييرات
* إذا تسبب إصدار جديد في مشاكل، فاستعد الإصدار السابق
* استخدم سجل الإصدارات لتتبُّع ما تغيّر
* اختبر دائمًا الإصدارات المُستعادة قبل التنشيط
## سير العمل الشائعة
### تحرير سريع
1. أجرِ تغييرات طفيفة على سير عمل نشط
2. اختبر في وضع المسودة
3. قم بتنشيط الإصدار الجديد
### مراجعة رئيسية
1. استخدم الإصدار السابق كنقطة انطلاق
2. أجرِ تغييرات كبيرة في المسودة
3. اختبر جميع السيناريوهات بشكل شامل
4. قم بالتنشيط عندما تكون واثقًا
### الرجوع إلى إصدار سابق
1. حدِّد المشكلة في الإصدار الحالي
2. اعثر على آخر إصدار يعمل في السجل
3. انقر **استخدام كمسودة**
4. قم بالتنشيط لاستعادة السلوك السابق
## ذات صلة
* [البدء مع سير العمل](/l/ar/user-guide/workflows/overview)
* [تشغيلات سير العمل](/l/ar/user-guide/workflows/capabilities/workflow-runs)

View File

@@ -0,0 +1,82 @@
---
title: التعامل مع المصفوفات في إجراءات Code
description: تعلّم كيفية التعامل بشكل صحيح مع مُدخلات المصفوفات في إجراءات Code في سير العمل.
---
عند العمل مع المصفوفات في إجراءات Code، قد تواجه تحديين شائعين:
1. **مصفوفات مُمرَّرة كسلاسل نصية** — تصل البيانات من الأنظمة الخارجية أو من الخطوات السابقة كسلسلة نصية بدلاً من أن تكون مصفوفة فعلية
2. **لا يمكن تحديد عناصر فردية** — يمكنك تحديد المصفوفة كاملة فقط، وليس الحقول المحددة داخلها
يمكن حل كلا الأمرين باستخدام عقدة Code.
## تحليل المصفوفات من السلاسل النصية
غالباً ما تُمرَّر المصفوفات بين خطوات سير العمل كسلاسل نصية أو JSON بدلاً من مصفوفات أصلية. يحدث هذا عندما:
* استقبال البيانات من واجهات برمجة التطبيقات الخارجية عبر HTTP Request
* معالجة حمولات خطافات الويب
* تمرير البيانات بين خطوات سير العمل
**الحل**: أضف هذا النمط في بداية إجراء Code الخاص بك:
```javascript
export const main = async (params: {
users: any;
}): Promise<object> => {
const { users } = params;
// Handle input that may come as a string or an array
const usersFormatted = typeof users === "string" ? JSON.parse(users) : users;
// Now you can safely work with usersFormatted as an array
return {
users: usersFormatted.map((user) => ({
...user,
activityStatus: String(user.activityStatus).toUpperCase(),
})),
};
};
```
السطر الأساسي `typeof users === "string" ? JSON.parse(users) : users` يتحقق مما إذا كان الإدخال سلسلة نصية، ويُجري تحليله إذا لزم الأمر، أو يستخدمه مباشرة إذا كان مصفوفة بالفعل.
## استخراج الحقول الفردية من المصفوفات
قد يُرجِع خطّاف ويب مصفوفةً مثل `answers: [...]`، ولكن في خطوات سير العمل اللاحقة يمكنك تحديد **المصفوفة بأكملها** فقط — وليس العناصر الفردية داخلها.
**الحل**: أضف عقدة Code لاستخراج حقول محددة وإرجاعها ككائن منظَّم:
```javascript
export const main = async (params: {
answers: any;
}): Promise<object> => {
const { answers } = params;
// Handle input that may come as a string or an array
const answersFormatted = typeof answers === "string"
? JSON.parse(answers)
: answers;
// Extract specific fields from the array
const firstname = answersFormatted[0]?.text || "";
const name = answersFormatted[1]?.text || "";
return {
answer: {
firstname,
name
}
};
};
```
تعيد عقدة Code كائناً منظَّماً بدلاً من مصفوفة. في الخطوات اللاحقة، يمكنك الآن تحديد حقول فردية مثل `answer.firstname` و`answer.name` من منتقي المتغيرات.
<Tip>
**تريد التكرار على المصفوفة بدلًا من استخراج الحقول؟** عندما تُرجِع خطوة Code أو Logic Function مصفوفة على المستوى الأعلى، يمكنك تمريرها مباشرة إلى [Iterator](/l/ar/user-guide/workflows/capabilities/use-iterator): اختر خيار **Whole list** للخطوة كمُدخل لـ Iterator، ثم ارجع إلى كل عنصر باستخدام `{{iterator.currentItem}}` داخل الحلقة. في هذه الحالة، لا تحتاج إلى إعادة هيكلة المصفوفة إلى كائن.
</Tip>
<Tip>
انقر على أيقونة المربع في أعلى يمين محرر الكود لعرضه بملء الشاشة — فهذا مفيد لأن عرض المحرر الافتراضي محدود.
</Tip>

Some files were not shown because too many files have changed in this diff Show More