إضافة حقل إلى كيان

الهدف

إضافة حقل إلى كيان موجود حتى تتمكن سجلاته من تخزين معلومة إضافية.

المتطلبات المسبقة

• أنت مسجّل الدخول بدور المصمم (أو مسؤول المنصة).
• الكيان موجود بالفعل (راجع إنشاء كيان).

الخطوات

1. افتح الجداول، واختر البيئة، ثم اختر اسم الكيان من قائمة الكيانات لفتحه على تبويب الحقول.

2. أدخل الاسم المعروض للحقل الجديد (على سبيل المثال، Total).

3. أدخل الاسم المنطقي. تظهر بادئة ناشر الحل الذي تعمل فيه بجانب المربع وتُطبَّق تلقائيًا، فلا تكتب سوى بقية الاسم — إذ يصير total هو par_total.

   ويحدث ذلك على الجداول القياسية أيضًا. فـ Account وContact بلا بادئة خاصة بها لأن Parsware هي التي تشحنهما، أما العمود الذي تضيفه أنت إليهما فهو لك: يصير par_accountnumber لا accountnumber. فالأسماء بلا بادئة ملك للمنصّة، والاسم الذي تخترعه سيصطدم بالعمود التالي الذي تضيفه Parsware بالاسم نفسه.

4. اختر نوع البيانات. لا تظهر سوى الحقول المتعلقة بالنوع المختار:

   • نص — نص من سطر واحد (يمكنك تعيين طول أقصى؛ والقيمة الافتراضية 100).
   • نص متعدد الأسطر — نص طويل.
   • عدد صحيح — أعداد صحيحة.
   • عدد عشري — أعداد بفاصلة ثابتة. الدقة هي عدد الأرقام كلها، والمقياس هو كم منها يقع بعد الفاصلة. فـ12 و2 تسع حتى 9,999,999,999.99، بينما 2 و2 لا تسع شيئًا فوق 0.99. والقيمتان الافتراضيتان 18 و2، وهما ما تريده للمبالغ ما لم يكن لديك سبب لغيرهما.
   • قيمة منطقية — صواب/خطأ.
   • تاريخ/وقت — تاريخ ووقت.
   • حقل البحث — إشارة إلى سجل في كيان آخر؛ اختر الكيان الهدف (الكيان نفسه مستبعَد من الخيارات). إضافة حقل بحث تُنشئ تلقائيًا علاقة واحد-إلى-متعدد بين الكيانين — فلا تُنشئ العلاقة على حدة (راجع إنشاء علاقة بين الكيانات).
   • حقل البحث (عدة جداول) — إشارة إلى سجل في عدة جداول: عميل قد يكون حسابًا أو جهة اتصال. حدّد جدولين على الأقل؛ يخزّن الحقل عندئذٍ الجدول الذي يوجد فيه السجل إلى جانب معرّفه. ولا يحصل هذا النوع على مفتاح خارجي، وهو الشيء الوحيد الذي يتخلّى عنه في المقابل — راجع إضافة حقل بحث متعدد الجداول.
   • ترقيم تلقائي — رقم مرجعي تمنحه المنصة لكل سجل جديد، مثل CR-2026-00417. إعداده الوحيد هو تنسيق الرقم، وتظهر معاينته أثناء الكتابة؛ لا يكتب أحد القيمة، فلا مربع مطلوب له. انظر ترقيم السجلات تلقائيًا.

5. اختياريًا، علّم الحقل بأنه مطلوب.

6. اختر إضافة حقل.

7. يظهر الحقل في قائمة حقول الكيان، وعموده موجود بالفعل — لا شيء تضغطه بعد ذلك.

ما الذي يحدث خلف الكواليس

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

وإذا تعذّر إنشاء العمود، أُخرج الحقل مرة أخرى وأُبلغ عن الخطأ — فالحقل في هذه القائمة له دائمًا عمود خلفه. راجع ماذا يحدث عند حفظ جدول.

تعديل حقل

اختر مربع اختيار الحقل ثم اختر تعديل. وما يمكنك تغييره هو:

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

أما ما لا يمكنك تغييره فهو الاسم المنطقي للحقل ونوع بياناته — وفي حقل البحث أو مجموعة الخيارات — ما يشير إليه. تُعرض هذه مقفلة، لأن كل ما يستخدم الحقل يشير إليه باسمه، ولأن عموده يحمل أصلًا بيانات من نوع واحد جرى التحقق منها مقابل الهدف أو المجموعة الحالية. ولتغيير أيٍّ منها، احذف الحقل وأضفه من جديد.

تغيير حجم حقل تغييرٌ حقيقي في جدول البيانات، لأن عموده موجود بالفعل. إطالة حقل نصي تنجح دائمًا. أما تقصيره فيفشل إذا كان سجل ما يحمل قيمة أطول — فيُبلَّغ عن الخطأ بدل قصّ ما كتبه أحدهم. وسّع الحقل بدلًا من ذلك، أو نظّف البيانات أولًا.

حذف حقل

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

هناك ثلاثة أمور تستحق المعرفة قبل الحذف:

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

لا يمكن حذف الحقل الرئيسي للجدول. أما عمود البيانات نفسه فيبقى في الجدول — فحذف الحقل يزيله من التطبيق، لا من البيانات المخزَّنة.

حل المشكلات

• أضفتُ حقلًا لكنه لا يظهر في التطبيق. — العمود موجود بمجرد إضافة الحقل، لكن الحقل لا يُعرض إلا حيث وضعتَه. أضفه إلى النموذج أو العرض الذي تنظر إليه.
• «… must be lower snake-case and start with the publisher prefix.» — يجب أن يبدأ الاسم المنطقي للحقل بـ {prefix}_.
• «… must be namespaced by your publisher's prefix.» — أُرسل الحقل بلا بادئة أصلًا. فأعمدة Parsware القياسية وحدها هي التي تخلو من بادئة؛ أما كل ما تضيفه أنت فيحمل بادئة ناشرك، حتى على جدول قياسي.
• «A field named … already exists on this entity.» — اختر اسمًا منطقيًا مختلفًا؛ فأسماء الحقول فريدة داخل الكيان الواحد.
• «The lookup target entity … was not found.» — أنشئ الكيان الهدف أولًا، أو صحّح الهدف الذي اخترته.
• عند حفظ سجل يقول إن رقمًا «يجب ألا يزيد على 0 رقم قبل الفاصلة العشرية». — دقة الحقل تَعُدّ كل الأرقام، لا الأرقام العشرية وحدها. الحقل الذي يحمل مبالغ برقمين عشريين يريد دقة 12 ومقياس 2؛ أما دقة 2 ومقياس 2 فعمود لا يسع شيئًا فوق 0.99. نوع البيانات لا يتغيّر بعد الإنشاء، أمّا الدقة والمقياس فنعم: اختر الحقل، اضغط تحرير، ووسّعه.
• «Text maxLength must be between 1 and 4000.» / «Decimal precision/scale is out of range.» — عدّل الطول أو الدقة/المقياس إلى المدى المسموح به.
• «تعديل» غير متاح لحقل ما. — يحتاج تعديل إلى تحديد حقل واحد بالضبط، كما أن حقول النظام الخاصة بالمنصة (أُنشئ في، عُدّل بواسطة، ونحوها) غير قابلة للتعديل: فهي ملك المنصة لا ملك جدولك.
• تقصير حقل يُبلّغ عن «value too long for type …». — سجلٌ ما يحمل أصلًا قيمة أطول من الطول الجديد. ويُرفض التغيير بدل قصّها. وسّع الحقل بدلًا من ذلك، أو قصّر السجلات المخالفة أولًا.

سيناريوهات ذات صلة

• إنشاء كيان.
• ماذا يحدث عند حفظ جدول.
• إنشاء علاقة بين الكيانات.