Created by Github action Pulls the latest documentation translations from Crowdin for all supported languages: - French (fr) - Arabic (ar) - Czech (cs) - German (de) - Spanish (es) - Italian (it) - Japanese (ja) - Korean (ko) - Portuguese (pt) - Romanian (ro) - Russian (ru) - Turkish (tr) - Chinese (zh-CN) --------- Co-authored-by: github-actions <github-actions@twenty.com>
123 lines
9.0 KiB
Plaintext
123 lines
9.0 KiB
Plaintext
---
|
|
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.
|
|
|
|
يمكنك إعادة تنشيط الحقول القياسية والمخصصة أو لديك خيار حذفها نهائيًا.
|
|
|
|
## جعل الحقول فريدة
|
|
|
|
اجعل الحقل فريدًا لضمان عدم إمكانية أن تحتوي السجلات المميزة على نفس القيمة. على سبيل المثال، عناوين البريد الإلكتروني فريدة لكل شخص.
|
|
|
|
إذا ظهرت لك رسالة خطأ عند تعيين خاصية التفرد، فتحقق من وجود قيم مكررة في بياناتك (بما في ذلك السجلات المحذوفة).
|
|
|
|
## أفضل ممارسات تكوين الحقول
|
|
|
|
### اتفاقيات التسمية والقيود
|
|
|
|
* **يجب أن تكون الأسماء الفردية والجمع مختلفة**: يحتاج API الخاص بنا إلى أسماء مميزة للتغييرات
|
|
* **أسماء الحقول المحمية**: بعض الأسماء محجوزة للاستخدام الخاص بالنظام (مثل `Type`، `Application`)
|
|
|
|
### حقول العملة والهاتف
|
|
|
|
* **العملة الافتراضية**: يمكن تهيئتها عبر نموذج البيانات
|
|
* **أكواد الدول الافتراضية**: يمكن تهيئتها لحقول الهاتف عبر نموذج البيانات
|
|
|
|
### حقول الاختيار
|
|
|
|
* **يمكن اختيار خيار افتراضي** لكل حقل اختيار
|
|
|
|
### حقول نص السجلات
|
|
|
|
* **كل كائن لديه حقل عرض رئيسي واحد**: يظهر هذا الحقل في العمود الأول ويمثل السجل عند الربط بأشياء أخرى. يجب أن يكون حقل نصي. على سبيل المثال، يستخدم الأشخاص `الاسم` كحقل رئيسي، لذلك عندما تربط شخصًا بشركة، سترى اسمهم في عرض الشركة.
|