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,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>